home *** CD-ROM | disk | FTP | other *** search
| MacBinary | 1995-01-19 | 5.9 MB | [ONLN/HLX2] |
open in: 
MacOS 8.1
|
Win98
|
DOS
browse contents |
view JSON data
|
view as text
This file was processed as: MacBinary
(archive/macBinary).
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 10%
| dexvert
| MacBinary (archive/macBinary)
| fallback
| Supported |
| 100%
| file
| MacBinary II, inited, Tue Sep 6 10:26:57 1994, modified Thu Jan 19 07:10:26 1995, creator 'HLX2', type 'ONLN', 6212781 bytes "AppleSearch Client Dev Gde" , at 0x5ecd2d 25510 bytes resource
| default (weak)
| |
| 99%
| file
| data
| default
| |
| 100%
| TrID
| MacBinary 2
| default (weak)
| |
| 100%
| siegfried
| fmt/1762 MacBinary (II)
| default
| |
| 100%
| lsar
| MacBinary
| default
|
|
| id metadata |
|---|
| key | value |
|---|
| macFileType | [ONLN] |
| macFileCreator | [HLX2] |
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 1a 41 70 70 6c 65 53 | 65 61 72 63 68 20 43 6c |..AppleS|earch Cl|
|00000010| 69 65 6e 74 20 44 65 76 | 20 47 64 65 00 00 00 00 |ient Dev| Gde....|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 4f 4e 4c 4e 48 4c 58 | 32 01 00 00 00 00 00 00 |.ONLNHLX|2.......|
|00000050| 00 00 00 00 5e cc ad 00 | 00 63 a6 aa 92 2c b1 ab |....^...|.c...,..|
|00000060| 44 07 32 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |D.2.....|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 57 3c 00 00 |........|....W<..|
|00000080| f0 09 41 70 70 6c 65 53 | 65 61 72 63 68 20 43 6c |..AppleS|earch Cl|
|00000090| 69 65 6e 74 20 44 65 76 | 65 6c 6f 70 65 72 d5 73 |ient Dev|eloper.s|
|000000a0| 20 47 75 69 64 65 0d 0d | f0 09 41 70 70 6c 65 20 | Guide..|..Apple |
|000000b0| 43 6f 6d 70 75 74 65 72 | 2c 20 49 6e 63 2e 0d 54 |Computer|, Inc..T|
|000000c0| 68 69 73 20 6d 61 6e 75 | 61 6c 20 61 6e 64 20 74 |his manu|al and t|
|000000d0| 68 65 20 73 6f 66 74 77 | 61 72 65 20 64 65 73 63 |he softw|are desc|
|000000e0| 72 69 62 65 64 20 69 6e | 20 69 74 20 61 72 65 20 |ribed in| it are |
|000000f0| 63 6f 70 79 72 69 67 68 | 74 65 64 2c 20 77 69 74 |copyrigh|ted, wit|
|00000100| 68 20 61 6c 6c 20 72 69 | 67 68 74 73 20 72 65 73 |h all ri|ghts res|
|00000110| 65 72 76 65 64 2e 20 55 | 6e 64 65 72 20 74 68 65 |erved. U|nder the|
|00000120| 20 63 6f 70 79 72 69 67 | 68 74 20 6c 61 77 73 2c | copyrig|ht laws,|
|00000130| 20 74 68 69 73 20 6d 61 | 6e 75 61 6c 20 6f 72 20 | this ma|nual or |
|00000140| 74 68 65 20 73 6f 66 74 | 77 61 72 65 20 6d 61 79 |the soft|ware may|
|00000150| 20 6e 6f 74 20 62 65 20 | 63 6f 70 69 65 64 2c 20 | not be |copied, |
|00000160| 69 6e 20 77 68 6f 6c 65 | 20 6f 72 20 70 61 72 74 |in whole| or part|
|00000170| 2c 20 77 69 74 68 6f 75 | 74 20 77 72 69 74 74 65 |, withou|t writte|
|00000180| 6e 20 63 6f 6e 73 65 6e | 74 20 6f 66 20 41 70 70 |n consen|t of App|
|00000190| 6c 65 2c 20 65 78 63 65 | 70 74 20 69 6e 20 74 68 |le, exce|pt in th|
|000001a0| 65 20 6e 6f 72 6d 61 6c | 20 75 73 65 20 6f 66 20 |e normal| use of |
|000001b0| 74 68 65 20 73 6f 66 74 | 77 61 72 65 20 6f 72 20 |the soft|ware or |
|000001c0| 74 6f 20 6d 61 6b 65 20 | 61 20 62 61 63 6b 75 70 |to make |a backup|
|000001d0| 20 63 6f 70 79 20 6f 66 | 20 74 68 65 20 73 6f 66 | copy of| the sof|
|000001e0| 74 77 61 72 65 2e 20 54 | 68 65 20 73 61 6d 65 20 |tware. T|he same |
|000001f0| 70 72 6f 70 72 69 65 74 | 61 72 79 20 61 6e 64 20 |propriet|ary and |
|00000200| 63 6f 70 79 72 69 67 68 | 74 20 6e 6f 74 69 63 65 |copyrigh|t notice|
|00000210| 73 20 6d 75 73 74 20 62 | 65 20 61 66 66 69 78 65 |s must b|e affixe|
|00000220| 64 20 74 6f 20 61 6e 79 | 20 70 65 72 6d 69 74 74 |d to any| permitt|
|00000230| 65 64 20 63 6f 70 69 65 | 73 20 61 73 20 77 65 72 |ed copie|s as wer|
|00000240| 65 20 61 66 66 69 78 65 | 64 20 74 6f 20 74 68 65 |e affixe|d to the|
|00000250| 20 6f 72 69 67 69 6e 61 | 6c 2e 20 54 68 69 73 20 | origina|l. This |
|00000260| 65 78 63 65 70 74 69 6f | 6e 20 64 6f 65 73 20 6e |exceptio|n does n|
|00000270| 6f 74 20 61 6c 6c 6f 77 | 20 63 6f 70 69 65 73 20 |ot allow| copies |
|00000280| 74 6f 20 62 65 20 6d 61 | 64 65 20 66 6f 72 20 6f |to be ma|de for o|
|00000290| 74 68 65 72 73 2c 20 77 | 68 65 74 68 65 72 20 6f |thers, w|hether o|
|000002a0| 72 20 6e 6f 74 20 73 6f | 6c 64 2c 20 62 75 74 20 |r not so|ld, but |
|000002b0| 61 6c 6c 20 6f 66 20 74 | 68 65 20 6d 61 74 65 72 |all of t|he mater|
|000002c0| 69 61 6c 20 70 75 72 63 | 68 61 73 65 64 20 28 77 |ial purc|hased (w|
|000002d0| 69 74 68 20 61 6c 6c 20 | 62 61 63 6b 75 70 20 63 |ith all |backup c|
|000002e0| 6f 70 69 65 73 29 20 6d | 61 79 20 62 65 20 73 6f |opies) m|ay be so|
|000002f0| 6c 64 2c 20 67 69 76 65 | 6e 2c 20 6f 72 20 6c 6f |ld, give|n, or lo|
|00000300| 61 6e 65 64 20 74 6f 20 | 61 6e 6f 74 68 65 72 20 |aned to |another |
|00000310| 70 65 72 73 6f 6e 2e 20 | 55 6e 64 65 72 20 74 68 |person. |Under th|
|00000320| 65 20 6c 61 77 2c 20 63 | 6f 70 79 69 6e 67 20 69 |e law, c|opying i|
|00000330| 6e 63 6c 75 64 65 73 20 | 74 72 61 6e 73 6c 61 74 |ncludes |translat|
|00000340| 69 6e 67 20 69 6e 74 6f | 20 61 6e 6f 74 68 65 72 |ing into| another|
|00000350| 20 6c 61 6e 67 75 61 67 | 65 20 6f 72 20 66 6f 72 | languag|e or for|
|00000360| 6d 61 74 2e 0d 59 6f 75 | 20 6d 61 79 20 75 73 65 |mat..You| may use|
|00000370| 20 74 68 65 20 73 6f 66 | 74 77 61 72 65 20 6f 6e | the sof|tware on|
|00000380| 20 61 6e 79 20 63 6f 6d | 70 75 74 65 72 20 6f 77 | any com|puter ow|
|00000390| 6e 65 64 20 62 79 20 79 | 6f 75 2c 20 62 75 74 20 |ned by y|ou, but |
|000003a0| 65 78 74 72 61 20 63 6f | 70 69 65 73 20 63 61 6e |extra co|pies can|
|000003b0| 6e 6f 74 20 62 65 20 6d | 61 64 65 20 66 6f 72 20 |not be m|ade for |
|000003c0| 74 68 69 73 20 70 75 72 | 70 6f 73 65 2e 0d 54 68 |this pur|pose..Th|
|000003d0| 65 20 41 70 70 6c 65 20 | 6c 6f 67 6f 20 69 73 20 |e Apple |logo is |
|000003e0| 61 20 72 65 67 69 73 74 | 65 72 65 64 20 74 72 61 |a regist|ered tra|
|000003f0| 64 65 6d 61 72 6b 20 6f | 66 20 41 70 70 6c 65 20 |demark o|f Apple |
|00000400| 43 6f 6d 70 75 74 65 72 | 2c 20 49 6e 63 2e 20 55 |Computer|, Inc. U|
|00000410| 73 65 20 6f 66 20 74 68 | 65 20 d2 6b 65 79 62 6f |se of th|e .keybo|
|00000420| 61 72 64 d3 20 41 70 70 | 6c 65 20 6c 6f 67 6f 20 |ard. App|le logo |
|00000430| 28 4f 70 74 69 6f 6e 2d | 53 68 69 66 74 2d 6b 29 |(Option-|Shift-k)|
|00000440| 20 66 6f 72 20 63 6f 6d | 6d 65 72 63 69 61 6c 20 | for com|mercial |
|00000450| 70 75 72 70 6f 73 65 73 | 20 77 69 74 68 6f 75 74 |purposes| without|
|00000460| 20 74 68 65 20 70 72 69 | 6f 72 20 77 72 69 74 74 | the pri|or writt|
|00000470| 65 6e 20 63 6f 6e 73 65 | 6e 74 20 6f 66 20 41 70 |en conse|nt of Ap|
|00000480| 70 6c 65 20 6d 61 79 20 | 63 6f 6e 73 74 69 74 75 |ple may |constitu|
|00000490| 74 65 20 74 72 61 64 65 | 6d 61 72 6b 20 69 6e 66 |te trade|mark inf|
|000004a0| 72 69 6e 67 65 6d 65 6e | 74 20 61 6e 64 20 75 6e |ringemen|t and un|
|000004b0| 66 61 69 72 20 63 6f 6d | 70 65 74 69 74 69 6f 6e |fair com|petition|
|000004c0| 20 69 6e 20 76 69 6f 6c | 61 74 69 6f 6e 20 6f 66 | in viol|ation of|
|000004d0| 20 66 65 64 65 72 61 6c | 20 61 6e 64 20 73 74 61 | federal| and sta|
|000004e0| 74 65 20 6c 61 77 73 2e | 0d 45 76 65 72 79 20 65 |te laws.|.Every e|
|000004f0| 66 66 6f 72 74 20 68 61 | 73 20 62 65 65 6e 20 6d |ffort ha|s been m|
|00000500| 61 64 65 20 74 6f 20 65 | 6e 73 75 72 65 20 74 68 |ade to e|nsure th|
|00000510| 61 74 20 74 68 65 20 69 | 6e 66 6f 72 6d 61 74 69 |at the i|nformati|
|00000520| 6f 6e 20 69 6e 20 74 68 | 69 73 20 6d 61 6e 75 61 |on in th|is manua|
|00000530| 6c 20 69 73 20 61 63 63 | 75 72 61 74 65 2e 20 41 |l is acc|urate. A|
|00000540| 70 70 6c 65 20 69 73 20 | 6e 6f 74 20 72 65 73 70 |pple is |not resp|
|00000550| 6f 6e 73 69 62 6c 65 20 | 66 6f 72 20 70 72 69 6e |onsible |for prin|
|00000560| 74 69 6e 67 20 6f 72 20 | 63 6c 65 72 69 63 61 6c |ting or |clerical|
|00000570| 20 65 72 72 6f 72 73 2e | 0d a9 20 41 70 70 6c 65 | errors.|.. Apple|
|00000580| 20 43 6f 6d 70 75 74 65 | 72 2c 20 49 6e 63 2e 2c | Compute|r, Inc.,|
|00000590| 20 31 39 39 34 0d 32 30 | 35 32 35 20 4d 61 72 69 | 1994.20|525 Mari|
|000005a0| 61 6e 69 20 41 76 65 6e | 75 65 20 0d 43 75 70 65 |ani Aven|ue .Cupe|
|000005b0| 72 74 69 6e 6f 2c 20 43 | 41 20 39 35 30 31 34 2d |rtino, C|A 95014-|
|000005c0| 36 32 39 39 0d 28 34 30 | 38 29 20 39 39 36 2d 31 |6299.(40|8) 996-1|
|000005d0| 30 31 30 0d 41 70 70 6c | 65 2c 20 74 68 65 20 41 |010.Appl|e, the A|
|000005e0| 70 70 6c 65 20 6c 6f 67 | 6f 2c 20 41 70 70 6c 65 |pple log|o, Apple|
|000005f0| 4c 69 6e 6b 2c 20 41 70 | 70 6c 65 53 68 61 72 65 |Link, Ap|pleShare|
|00000600| 2c 20 41 70 70 6c 65 54 | 61 6c 6b 2c 20 4d 61 63 |, AppleT|alk, Mac|
|00000610| 41 70 70 2c 20 4d 61 63 | 69 6e 74 6f 73 68 2c 20 |App, Mac|intosh, |
|00000620| 61 6e 64 20 4d 50 57 20 | 61 72 65 20 74 72 61 64 |and MPW |are trad|
|00000630| 65 6d 61 72 6b 73 20 6f | 66 20 41 70 70 6c 65 20 |emarks o|f Apple |
|00000640| 43 6f 6d 70 75 74 65 72 | 2c 20 49 6e 63 2e 2c 20 |Computer|, Inc., |
|00000650| 72 65 67 69 73 74 65 72 | 65 64 20 69 6e 20 74 68 |register|ed in th|
|00000660| 65 20 55 6e 69 74 65 64 | 20 53 74 61 74 65 73 20 |e United| States |
|00000670| 61 6e 64 20 6f 74 68 65 | 72 20 63 6f 75 6e 74 72 |and othe|r countr|
|00000680| 69 65 73 2e 0d 41 70 70 | 6c 65 53 65 61 72 63 68 |ies..App|leSearch|
|00000690| 20 61 6e 64 20 46 69 6e | 64 65 72 20 61 72 65 20 | and Fin|der are |
|000006a0| 74 72 61 64 65 6d 61 72 | 6b 73 20 6f 66 20 41 70 |trademar|ks of Ap|
|000006b0| 70 6c 65 20 43 6f 6d 70 | 75 74 65 72 2c 20 49 6e |ple Comp|uter, In|
|000006c0| 63 2e 20 0d 4d 61 63 57 | 72 69 74 65 20 69 73 20 |c. .MacW|rite is |
|000006d0| 61 20 72 65 67 69 73 74 | 65 72 65 64 20 74 72 61 |a regist|ered tra|
|000006e0| 64 65 6d 61 72 6b 20 6f | 66 20 43 6c 61 72 69 73 |demark o|f Claris|
|000006f0| 20 43 6f 72 70 6f 72 61 | 74 69 6f 6e 2e 0d 53 69 | Corpora|tion..Si|
|00000700| 6d 75 6c 74 61 6e 65 6f | 75 73 6c 79 20 70 75 62 |multaneo|usly pub|
|00000710| 6c 69 73 68 65 64 20 69 | 6e 20 74 68 65 20 55 6e |lished i|n the Un|
|00000720| 69 74 65 64 20 53 74 61 | 74 65 73 20 61 6e 64 20 |ited Sta|tes and |
|00000730| 43 61 6e 61 64 61 2e 0d | 4d 65 6e 74 69 6f 6e 20 |Canada..|Mention |
|00000740| 6f 66 20 74 68 69 72 64 | 2d 70 61 72 74 79 20 70 |of third|-party p|
|00000750| 72 6f 64 75 63 74 73 20 | 69 73 20 66 6f 72 20 69 |roducts |is for i|
|00000760| 6e 66 6f 72 6d 61 74 69 | 6f 6e 61 6c 20 70 75 72 |nformati|onal pur|
|00000770| 70 6f 73 65 73 20 6f 6e | 6c 79 20 61 6e 64 20 63 |poses on|ly and c|
|00000780| 6f 6e 73 74 69 74 75 74 | 65 73 20 6e 65 69 74 68 |onstitut|es neith|
|00000790| 65 72 20 61 6e 20 65 6e | 64 6f 72 73 65 6d 65 6e |er an en|dorsemen|
|000007a0| 74 20 6e 6f 72 20 61 20 | 72 65 63 6f 6d 6d 65 6e |t nor a |recommen|
|000007b0| 64 61 74 69 6f 6e 2e 20 | 41 70 70 6c 65 20 61 73 |dation. |Apple as|
|000007c0| 73 75 6d 65 73 20 6e 6f | 20 72 65 73 70 6f 6e 73 |sumes no| respons|
|000007d0| 69 62 69 6c 69 74 79 20 | 77 69 74 68 20 72 65 67 |ibility |with reg|
|000007e0| 61 72 64 20 74 6f 20 74 | 68 65 20 70 65 72 66 6f |ard to t|he perfo|
|000007f0| 72 6d 61 6e 63 65 20 6f | 72 20 75 73 65 20 6f 66 |rmance o|r use of|
|00000800| 20 74 68 65 73 65 20 70 | 72 6f 64 75 63 74 73 2e | these p|roducts.|
|00000810| 0d 0d 43 6f 6e 74 65 6e | 74 73 0d 50 72 65 66 61 |..Conten|ts.Prefa|
|00000820| 63 65 ca ca 2f ca ca 76 | 69 69 0d 09 31 09 41 72 |ce../..v|ii..1.Ar|
|00000830| 63 68 69 74 65 63 74 75 | 72 61 6c 20 4f 76 65 72 |chitectu|ral Over|
|00000840| 76 69 65 77 ca ca 2f ca | ca 31 0d 41 70 70 6c 65 |view../.|.1.Apple|
|00000850| 53 65 61 72 63 68 20 73 | 6f 66 74 77 61 72 65 20 |Search s|oftware |
|00000860| 63 6f 6d 70 6f 6e 65 6e | 74 73 ca ca 2f ca ca 32 |componen|ts../..2|
|00000870| 0d 57 72 69 74 69 6e 67 | 20 79 6f 75 72 20 6f 77 |.Writing| your ow|
|00000880| 6e 20 63 6c 69 65 6e 74 | 20 61 70 70 6c 69 63 61 |n client| applica|
|00000890| 74 69 6f 6e ca ca 2f ca | ca 33 0d 43 6c 69 65 6e |tion../.|.3.Clien|
|000008a0| 74 2f 73 65 72 76 65 72 | 20 63 6f 6e 6e 65 63 74 |t/server| connect|
|000008b0| 69 6f 6e ca ca 2f ca ca | 34 0d 49 6e 66 6f 72 6d |ion../..|4.Inform|
|000008c0| 61 74 69 6f 6e 20 73 6f | 75 72 63 65 73 ca ca 2f |ation so|urces../|
|000008d0| ca ca 35 0d 49 6d 6d 65 | 64 69 61 74 65 20 73 65 |..5.Imme|diate se|
|000008e0| 61 72 63 68 65 73 ca ca | 2f ca ca 35 0d 41 72 74 |arches..|/..5.Art|
|000008f0| 69 63 6c 65 20 72 65 74 | 72 69 65 76 61 6c ca ca |icle ret|rieval..|
|00000900| 2f ca ca 36 0d 4f 72 69 | 67 69 6e 61 6c 20 66 69 |/..6.Ori|ginal fi|
|00000910| 6c 65 20 72 65 74 72 69 | 65 76 61 6c ca ca 2f ca |le retri|eval../.|
|00000920| ca 36 0d 53 63 68 65 64 | 75 6c 65 64 20 73 65 61 |.6.Sched|uled sea|
|00000930| 72 63 68 65 73 ca ca 2f | ca ca 37 0d 53 65 72 76 |rches../|..7.Serv|
|00000940| 65 72 20 6f 62 6a 65 63 | 74 20 64 61 74 61 62 61 |er objec|t databa|
|00000950| 73 65 ca ca 2f ca ca 37 | 0d 09 32 09 41 70 70 6c |se../..7|..2.Appl|
|00000960| 65 20 45 76 65 6e 74 73 | 20 41 70 70 6c 69 63 61 |e Events| Applica|
|00000970| 74 69 6f 6e 20 50 72 6f | 67 72 61 6d 6d 69 6e 67 |tion Pro|gramming|
|00000980| 20 49 6e 74 65 72 66 61 | 63 65 ca ca 2f ca ca 39 | Interfa|ce../..9|
|00000990| 0d 53 65 6e 64 69 6e 67 | 20 61 6e 64 20 72 65 63 |.Sending| and rec|
|000009a0| 65 69 76 69 6e 67 20 41 | 70 70 6c 65 53 65 61 72 |eiving A|ppleSear|
|000009b0| 63 68 20 41 70 70 6c 65 | 20 65 76 65 6e 74 73 ca |ch Apple| events.|
|000009c0| ca 2f ca ca 31 30 0d 54 | 68 65 20 41 70 70 6c 65 |./..10.T|he Apple|
|000009d0| 53 65 61 72 63 68 20 43 | 6f 6d 6d 75 6e 69 63 61 |Search C|ommunica|
|000009e0| 74 69 6f 6e 20 45 78 74 | 65 6e 73 69 6f 6e ca ca |tion Ext|ension..|
|000009f0| 2f ca ca 31 31 0d 43 6f | 6e 6e 65 63 74 69 6e 67 |/..11.Co|nnecting|
|00000a00| 20 74 6f 20 61 20 73 65 | 72 76 65 72 ca ca 2f ca | to a se|rver../.|
|00000a10| ca 31 35 0d 41 70 70 6c | 65 20 65 76 65 6e 74 20 |.15.Appl|e event |
|00000a20| 41 50 49 20 63 61 6c 6c | 73 ca ca 2f ca ca 31 35 |API call|s../..15|
|00000a30| 0d 52 65 67 69 73 74 65 | 72 ca ca 2f ca ca 31 36 |.Registe|r../..16|
|00000a40| 0d 55 6e 72 65 67 69 73 | 74 65 72 ca ca 2f ca ca |.Unregis|ter../..|
|00000a50| 31 37 0d 4c 6f 67 6f 6e | ca ca 2f ca ca 31 38 0d |17.Logon|../..18.|
|00000a60| 53 65 74 20 41 75 74 6f | 20 4c 6f 67 6f 6e ca ca |Set Auto| Logon..|
|00000a70| 2f ca ca 32 30 0d 47 65 | 74 20 41 75 74 6f 20 4c |/..20.Ge|t Auto L|
|00000a80| 6f 67 6f 6e ca ca 2f ca | ca 32 31 0d 4c 6f 67 6f |ogon../.|.21.Logo|
|00000a90| 66 66 ca ca 2f ca ca 32 | 32 0d 53 74 61 74 75 73 |ff../..2|2.Status|
|00000aa0| 20 43 68 61 6e 67 65 64 | ca ca 2f ca ca 32 33 0d | Changed|../..23.|
|00000ab0| 45 6e 75 6d 65 72 61 74 | 65 20 53 6f 75 72 63 65 |Enumerat|e Source|
|00000ac0| 73 ca ca 2f ca ca 32 33 | 0d 4f 70 65 6e 20 53 65 |s../..23|.Open Se|
|00000ad0| 61 72 63 68 20 53 65 73 | 73 69 6f 6e ca ca 2f ca |arch Ses|sion../.|
|00000ae0| ca 32 35 0d 43 6c 6f 73 | 65 20 53 65 61 72 63 68 |.25.Clos|e Search|
|00000af0| 20 53 65 73 73 69 6f 6e | ca ca 2f ca ca 32 36 0d | Session|../..26.|
|00000b00| 53 65 61 72 63 68 ca ca | 2f ca ca 32 39 0d 47 65 |Search..|/..29.Ge|
|00000b10| 74 20 52 65 6c 61 74 65 | 64 20 54 65 72 6d 73 ca |t Relate|d Terms.|
|00000b20| ca 2f ca ca 33 31 0d 47 | 65 74 20 41 72 74 69 63 |./..31.G|et Artic|
|00000b30| 6c 65 20 54 65 78 74 ca | ca 2f ca ca 33 33 0d 47 |le Text.|./..33.G|
|00000b40| 65 74 20 41 72 74 69 63 | 6c 65 20 49 6e 66 6f ca |et Artic|le Info.|
|00000b50| ca 2f ca ca 33 35 0d 47 | 65 74 20 41 72 74 69 63 |./..35.G|et Artic|
|00000b60| 6c 65 20 4d 61 74 63 68 | 65 73 ca ca 2f ca ca 33 |le Match|es../..3|
|00000b70| 37 0d 41 64 64 20 52 65 | 70 6f 72 74 65 72 ca ca |7.Add Re|porter..|
|00000b80| 2f ca ca 33 39 0d 4d 6f | 64 69 66 79 20 52 65 70 |/..39.Mo|dify Rep|
|00000b90| 6f 72 74 65 72 ca ca 2f | ca ca 34 33 0d 47 65 74 |orter../|..43.Get|
|00000ba0| 20 52 65 70 6f 72 74 65 | 72 ca ca 2f ca ca 34 37 | Reporte|r../..47|
|00000bb0| 0d 44 65 6c 65 74 65 20 | 52 65 70 6f 72 74 65 72 |.Delete |Reporter|
|00000bc0| ca ca 2f ca ca 34 39 0d | 45 6e 75 6d 65 72 61 74 |../..49.|Enumerat|
|00000bd0| 65 20 52 65 70 6f 72 74 | 65 72 73 ca ca 2f ca ca |e Report|ers../..|
|00000be0| 35 31 0d 41 64 64 20 44 | 42 20 4f 62 6a 65 63 74 |51.Add D|B Object|
|00000bf0| ca ca 2f ca ca 35 32 0d | 4d 6f 64 69 66 79 20 44 |../..52.|Modify D|
|00000c00| 42 20 4f 62 6a 65 63 74 | ca ca 2f ca ca 35 34 0d |B Object|../..54.|
|00000c10| 47 65 74 20 44 42 20 4f | 62 6a 65 63 74 ca ca 2f |Get DB O|bject../|
|00000c20| ca ca 35 36 0d 44 65 6c | 65 74 65 20 44 42 20 4f |..56.Del|ete DB O|
|00000c30| 62 6a 65 63 74 ca ca 2f | ca ca 35 38 0d 45 6e 75 |bject../|..58.Enu|
|00000c40| 6d 65 72 61 74 65 20 44 | 42 20 4f 62 6a 65 63 74 |merate D|B Object|
|00000c50| 73 ca ca 2f ca ca 35 39 | 0d 49 6d 70 6f 72 74 20 |s../..59|.Import |
|00000c60| 52 65 70 6f 72 74 65 72 | ca ca 2f ca ca 36 31 0d |Reporter|../..61.|
|00000c70| 45 78 70 6f 72 74 20 52 | 65 70 6f 72 74 65 72 ca |Export R|eporter.|
|00000c80| ca 2f ca ca 36 32 0d 47 | 65 74 20 4f 72 69 67 69 |./..62.G|et Origi|
|00000c90| 6e 61 6c 20 46 69 6c 65 | ca ca 2f ca ca 36 34 0d |nal File|../..64.|
|00000ca0| 09 33 09 43 20 4c 69 62 | 72 61 72 79 20 41 70 70 |.3.C Lib|rary App|
|00000cb0| 6c 69 63 61 74 69 6f 6e | 20 50 72 6f 67 72 61 6d |lication| Program|
|00000cc0| 6d 69 6e 67 20 49 6e 74 | 65 72 66 61 63 65 ca ca |ming Int|erface..|
|00000cd0| 2f ca ca 36 37 0d 4d 61 | 6b 69 6e 67 20 61 20 43 |/..67.Ma|king a C|
|00000ce0| 20 4c 69 62 72 61 72 79 | 20 41 50 49 20 66 75 6e | Library| API fun|
|00000cf0| 63 74 69 6f 6e 20 63 61 | 6c 6c ca ca 2f ca ca 36 |ction ca|ll../..6|
|00000d00| 38 0d 43 6f 6d 70 6c 65 | 74 69 6f 6e 20 72 6f 75 |8.Comple|tion rou|
|00000d10| 74 69 6e 65 73 ca ca 2f | ca ca 36 39 0d 45 72 72 |tines../|..69.Err|
|00000d20| 6f 72 73 ca ca 2f ca ca | 36 39 0d 49 6e 69 74 69 |ors../..|69.Initi|
|00000d30| 61 6c 69 7a 69 6e 67 20 | 74 68 65 20 41 70 70 6c |alizing |the Appl|
|00000d40| 65 53 65 61 72 63 68 20 | 43 6c 69 65 6e 74 20 4c |eSearch |Client L|
|00000d50| 69 62 72 61 72 79 20 61 | 6e 64 20 63 6f 6e 6e 65 |ibrary a|nd conne|
|00000d60| 63 74 69 6e 67 20 0d 74 | 6f 20 61 20 73 65 72 76 |cting .t|o a serv|
|00000d70| 65 72 ca ca 2f ca ca 37 | 30 0d 42 75 69 6c 64 69 |er../..7|0.Buildi|
|00000d80| 6e 67 20 79 6f 75 72 20 | 61 70 70 6c 69 63 61 74 |ng your |applicat|
|00000d90| 69 6f 6e ca ca 2f ca ca | 37 30 0d 43 20 4c 69 62 |ion../..|70.C Lib|
|00000da0| 72 61 72 79 20 41 50 49 | 20 63 61 6c 6c 73 ca ca |rary API| calls..|
|00000db0| 2f ca ca 37 32 0d 41 53 | 49 6e 69 74 69 61 6c 69 |/..72.AS|Initiali|
|00000dc0| 7a 65 ca ca 2f ca ca 37 | 32 0d 41 53 51 75 69 74 |ze../..7|2.ASQuit|
|00000dd0| ca ca 2f ca ca 37 32 0d | 41 53 44 6f 49 64 6c 65 |../..72.|ASDoIdle|
|00000de0| ca ca 2f ca ca 37 32 0d | 41 53 52 65 67 69 73 74 |../..72.|ASRegist|
|00000df0| 65 72 ca ca 2f ca ca 37 | 33 0d 41 53 55 6e 72 65 |er../..7|3.ASUnre|
|00000e00| 67 69 73 74 65 72 ca ca | 2f ca ca 37 34 0d 41 53 |gister..|/..74.AS|
|00000e10| 53 65 6c 65 63 74 53 65 | 72 76 65 72 ca ca 2f ca |SelectSe|rver../.|
|00000e20| ca 37 35 0d 41 53 4c 6f | 67 6f 6e ca ca 2f ca ca |.75.ASLo|gon../..|
|00000e30| 37 36 0d 41 53 4c 6f 67 | 6f 66 66 ca ca 2f ca ca |76.ASLog|off../..|
|00000e40| 37 39 0d 41 53 45 6e 75 | 6d 65 72 61 74 65 53 6f |79.ASEnu|merateSo|
|00000e50| 75 72 63 65 73 ca ca 2f | ca ca 38 30 0d 41 53 4f |urces../|..80.ASO|
|00000e60| 70 65 6e 53 65 61 72 63 | 68 53 65 73 73 69 6f 6e |penSearc|hSession|
|00000e70| ca ca 2f ca ca 38 31 0d | 41 53 43 6c 6f 73 65 53 |../..81.|ASCloseS|
|00000e80| 65 61 72 63 68 53 65 73 | 73 69 6f 6e ca ca 2f ca |earchSes|sion../.|
|00000e90| ca 38 33 0d 41 53 53 65 | 61 72 63 68 ca ca 2f ca |.83.ASSe|arch../.|
|00000ea0| ca 38 34 0d 41 53 47 65 | 74 52 65 6c 61 74 65 64 |.84.ASGe|tRelated|
|00000eb0| 54 65 72 6d 73 ca ca 2f | ca ca 38 37 0d 41 53 47 |Terms../|..87.ASG|
|00000ec0| 65 74 41 72 74 69 63 6c | 65 54 65 78 74 ca ca 2f |etArticl|eText../|
|00000ed0| ca ca 38 39 0d 41 53 47 | 65 74 41 72 74 69 63 6c |..89.ASG|etArticl|
|00000ee0| 65 49 6e 66 6f ca ca 2f | ca ca 39 31 0d 41 53 47 |eInfo../|..91.ASG|
|00000ef0| 65 74 41 72 74 69 63 6c | 65 4d 61 74 63 68 65 73 |etArticl|eMatches|
|00000f00| ca ca 2f ca ca 39 32 0d | 41 53 41 64 64 52 65 70 |../..92.|ASAddRep|
|00000f10| 6f 72 74 65 72 ca ca 2f | ca ca 39 35 0d 41 53 4d |orter../|..95.ASM|
|00000f20| 6f 64 69 66 79 52 65 70 | 6f 72 74 65 72 ca ca 2f |odifyRep|orter../|
|00000f30| ca ca 39 38 0d 41 53 47 | 65 74 52 65 70 6f 72 74 |..98.ASG|etReport|
|00000f40| 65 72 ca ca 2f ca ca 31 | 30 32 0d 41 53 44 65 6c |er../..1|02.ASDel|
|00000f50| 65 74 65 52 65 70 6f 72 | 74 65 72 ca ca 2f ca ca |eteRepor|ter../..|
|00000f60| 31 30 34 0d 41 53 45 6e | 75 6d 65 72 61 74 65 52 |104.ASEn|umerateR|
|00000f70| 65 70 6f 72 74 65 72 73 | ca ca 2f ca ca 31 30 35 |eporters|../..105|
|00000f80| 0d 41 53 41 64 64 44 42 | 4f 62 6a 65 63 74 ca ca |.ASAddDB|Object..|
|00000f90| 2f ca ca 31 30 37 0d 41 | 53 4d 6f 64 69 66 79 44 |/..107.A|SModifyD|
|00000fa0| 42 4f 62 6a 65 63 74 ca | ca 2f ca ca 31 30 38 0d |BObject.|./..108.|
|00000fb0| 41 53 47 65 74 44 42 4f | 62 6a 65 63 74 ca ca 2f |ASGetDBO|bject../|
|00000fc0| ca ca 31 31 30 0d 41 53 | 44 65 6c 65 74 65 44 42 |..110.AS|DeleteDB|
|00000fd0| 4f 62 6a 65 63 74 ca ca | 2f ca ca 31 31 32 0d 41 |Object..|/..112.A|
|00000fe0| 53 45 6e 75 6d 65 72 61 | 74 65 44 42 4f 62 6a 65 |SEnumera|teDBObje|
|00000ff0| 63 74 73 ca ca 2f ca ca | 31 31 33 0d 41 53 49 6d |cts../..|113.ASIm|
|00001000| 70 6f 72 74 52 65 70 6f | 72 74 65 72 ca ca 2f ca |portRepo|rter../.|
|00001010| ca 31 31 35 0d 41 53 45 | 78 70 6f 72 74 52 65 70 |.115.ASE|xportRep|
|00001020| 6f 72 74 65 72 ca ca 2f | ca ca 31 31 36 0d 41 53 |orter../|..116.AS|
|00001030| 47 65 74 4f 72 69 67 69 | 6e 61 6c 46 69 6c 65 ca |GetOrigi|nalFile.|
|00001040| ca 2f ca ca 31 31 37 0d | 09 41 70 70 65 6e 64 69 |./..117.|.Appendi|
|00001050| 78 20 41 09 43 6f 6e 73 | 74 61 6e 74 73 20 61 6e |x A.Cons|tants an|
|00001060| 64 20 45 72 72 6f 72 73 | ca ca 2f ca ca 31 31 39 |d Errors|../..119|
|00001070| 0d 53 65 61 72 63 68 20 | 70 61 72 61 6d 65 74 65 |.Search |paramete|
|00001080| 72 20 62 6c 6f 63 6b d0 | 72 65 6c 61 74 65 64 20 |r block.|related |
|00001090| 63 6f 6e 73 74 61 6e 74 | 73 ca ca 2f ca ca 31 31 |constant|s../..11|
|000010a0| 39 0d 52 65 70 6f 72 74 | 65 72 20 70 61 72 61 6d |9.Report|er param|
|000010b0| 65 74 65 72 20 62 6c 6f | 63 6b d0 72 65 6c 61 74 |eter blo|ck.relat|
|000010c0| 65 64 20 63 6f 6e 73 74 | 61 6e 74 73 ca ca 2f ca |ed const|ants../.|
|000010d0| ca 31 31 39 0d 47 65 74 | 20 54 65 78 74 2f 47 65 |.119.Get| Text/Ge|
|000010e0| 74 20 4f 72 69 67 69 6e | 61 6c 20 70 61 72 61 6d |t Origin|al param|
|000010f0| 65 74 65 72 20 62 6c 6f | 63 6b d0 72 65 6c 61 74 |eter blo|ck.relat|
|00001100| 65 64 20 63 6f 6e 73 74 | 61 6e 74 73 ca ca 2f ca |ed const|ants../.|
|00001110| ca 31 31 39 0d 47 65 74 | 20 52 65 6c 61 74 65 64 |.119.Get| Related|
|00001120| 20 54 65 72 6d 73 20 70 | 61 72 61 6d 65 74 65 72 | Terms p|arameter|
|00001130| 20 62 6c 6f 63 6b d0 72 | 65 6c 61 74 65 64 20 63 | block.r|elated c|
|00001140| 6f 6e 73 74 61 6e 74 73 | ca ca 2f ca ca 31 31 39 |onstants|../..119|
|00001150| 0d 43 6c 69 65 6e 74 2d | 67 65 6e 65 72 61 74 65 |.Client-|generate|
|00001160| 64 20 65 72 72 6f 72 73 | ca ca 2f ca ca 31 32 30 |d errors|../..120|
|00001170| 0d 53 65 72 76 65 72 2d | 67 65 6e 65 72 61 74 65 |.Server-|generate|
|00001180| 64 20 65 72 72 6f 72 73 | ca ca 2f ca ca 31 32 30 |d errors|../..120|
|00001190| 0d 09 41 70 70 65 6e 64 | 69 78 20 42 09 41 70 70 |..Append|ix B.App|
|000011a0| 6c 65 20 45 76 65 6e 74 | 73 20 53 75 6d 6d 61 72 |le Event|s Summar|
|000011b0| 79 ca ca 2f ca ca 31 32 | 33 0d 45 76 65 6e 74 20 |y../..12|3.Event |
|000011c0| 63 6c 61 73 73 65 73 ca | ca 2f ca ca 31 32 33 0d |classes.|./..123.|
|000011d0| 45 76 65 6e 74 20 49 44 | 73 ca ca 2f ca ca 31 32 |Event ID|s../..12|
|000011e0| 33 0d 41 70 70 6c 65 20 | 65 76 65 6e 74 20 6b 65 |3.Apple |event ke|
|000011f0| 79 77 6f 72 64 73 ca ca | 2f ca ca 31 32 34 0d 53 |ywords..|/..124.S|
|00001200| 74 72 75 63 74 75 72 65 | 73 ca ca 2f ca ca 31 32 |tructure|s../..12|
|00001210| 35 0d 09 41 70 70 65 6e | 64 69 78 20 43 09 43 20 |5..Appen|dix C.C |
|00001220| 4c 69 62 72 61 72 79 20 | 53 75 6d 6d 61 72 79 ca |Library |Summary.|
|00001230| ca 2f ca ca 31 32 37 0d | 4f 62 6a 65 63 74 20 74 |./..127.|Object t|
|00001240| 79 70 65 73 ca ca 2f ca | ca 31 32 37 0d 54 79 70 |ypes../.|.127.Typ|
|00001250| 65 20 64 65 66 69 6e 69 | 74 69 6f 6e 73 ca ca 2f |e defini|tions../|
|00001260| ca ca 31 32 37 0d 50 61 | 72 61 6d 65 74 65 72 20 |..127.Pa|rameter |
|00001270| 62 6c 6f 63 6b 73 ca ca | 2f ca ca 31 32 37 0d 41 |blocks..|/..127.A|
|00001280| 53 52 65 67 69 73 74 65 | 72 50 42 ca ca 2f ca ca |SRegiste|rPB../..|
|00001290| 31 32 37 0d 41 53 53 65 | 6c 65 63 74 53 65 72 76 |127.ASSe|lectServ|
|000012a0| 65 72 50 42 ca ca 2f ca | ca 31 32 38 0d 41 53 4c |erPB../.|.128.ASL|
|000012b0| 6f 67 6f 6e 50 42 ca ca | 2f ca ca 31 32 38 0d 41 |ogonPB..|/..128.A|
|000012c0| 53 4c 6f 67 6f 66 66 50 | 42 ca ca 2f ca ca 31 32 |SLogoffP|B../..12|
|000012d0| 38 0d 41 53 53 65 61 72 | 63 68 53 65 73 73 69 6f |8.ASSear|chSessio|
|000012e0| 6e 50 42 ca ca 2f ca ca | 31 32 38 0d 41 53 45 6e |nPB../..|128.ASEn|
|000012f0| 75 6d 65 72 61 74 65 50 | 42 ca ca 2f ca ca 31 32 |umerateP|B../..12|
|00001300| 39 0d 41 53 53 65 61 72 | 63 68 50 42 ca ca 2f ca |9.ASSear|chPB../.|
|00001310| ca 31 32 39 0d 41 53 47 | 65 74 41 72 74 69 63 6c |.129.ASG|etArticl|
|00001320| 65 49 6e 66 6f 50 42 ca | ca 2f ca ca 31 33 30 0d |eInfoPB.|./..130.|
|00001330| 41 53 47 65 74 41 72 74 | 69 63 6c 65 54 65 78 74 |ASGetArt|icleText|
|00001340| 50 42 ca ca 2f ca ca 31 | 33 30 0d 41 53 47 65 74 |PB../..1|30.ASGet|
|00001350| 41 72 74 69 63 6c 65 4d | 61 74 63 68 65 73 50 42 |ArticleM|atchesPB|
|00001360| ca ca 2f ca ca 31 33 31 | 0d 41 53 47 65 74 46 69 |../..131|.ASGetFi|
|00001370| 6c 65 50 42 ca ca 2f ca | ca 31 33 31 0d 41 53 52 |lePB../.|.131.ASR|
|00001380| 65 70 6f 72 74 65 72 50 | 42 ca ca 2f ca ca 31 33 |eporterP|B../..13|
|00001390| 32 0d 44 42 4f 62 6a 65 | 63 74 50 42 ca ca 2f ca |2.DBObje|ctPB../.|
|000013a0| ca 31 33 32 0d 41 53 49 | 6d 70 6f 72 74 45 78 70 |.132.ASI|mportExp|
|000013b0| 6f 72 74 50 42 ca ca 2f | ca ca 31 33 32 0d 41 53 |ortPB../|..132.AS|
|000013c0| 47 65 74 52 65 6c 61 74 | 65 64 54 65 72 6d 73 50 |GetRelat|edTermsP|
|000013d0| 42 ca ca 2f ca ca 31 33 | 33 0d 43 20 41 50 49 20 |B../..13|3.C API |
|000013e0| 66 75 6e 63 74 69 6f 6e | 73 ca ca 2f ca ca 31 33 |function|s../..13|
|000013f0| 33 0d 48 6f 75 73 65 6b | 65 65 70 69 6e 67 20 72 |3.Housek|eeping r|
|00001400| 6f 75 74 69 6e 65 73 ca | ca 2f ca ca 31 33 33 0d |outines.|./..133.|
|00001410| 53 65 61 72 63 68 20 72 | 6f 75 74 69 6e 65 73 ca |Search r|outines.|
|00001420| ca 2f ca ca 31 33 33 0d | 44 61 74 61 20 72 65 74 |./..133.|Data ret|
|00001430| 72 69 65 76 61 6c 20 72 | 6f 75 74 69 6e 65 73 ca |rieval r|outines.|
|00001440| ca 2f ca ca 31 33 34 0d | 52 65 70 6f 72 74 65 72 |./..134.|Reporter|
|00001450| 20 72 6f 75 74 69 6e 65 | 73 ca ca 2f ca ca 31 33 | routine|s../..13|
|00001460| 34 0d 44 42 4f 62 6a 65 | 63 74 20 72 6f 75 74 69 |4.DBObje|ct routi|
|00001470| 6e 65 73 ca ca 2f ca ca | 31 33 34 0d 50 72 65 66 |nes../..|134.Pref|
|00001480| 61 63 65 0d 41 70 70 6c | 65 53 65 61 72 63 68 20 |ace.Appl|eSearch |
|00001490| 69 73 20 66 75 6c 6c 2d | 74 65 78 74 20 73 65 61 |is full-|text sea|
|000014a0| 72 63 68 2d 61 6e 64 2d | 72 65 74 72 69 65 76 61 |rch-and-|retrieva|
|000014b0| 6c 20 77 6f 72 6b 67 72 | 6f 75 70 20 73 6f 66 74 |l workgr|oup soft|
|000014c0| 77 61 72 65 20 74 68 61 | 74 20 61 6c 6c 6f 77 73 |ware tha|t allows|
|000014d0| 20 75 73 65 72 73 20 74 | 6f 20 72 65 74 72 69 65 | users t|o retrie|
|000014e0| 76 65 20 63 75 73 74 6f | 6d 69 7a 65 64 20 69 6e |ve custo|mized in|
|000014f0| 66 6f 72 6d 61 74 69 6f | 6e 20 66 72 6f 6d 20 75 |formatio|n from u|
|00001500| 6e 73 74 72 75 63 74 75 | 72 65 64 20 64 6f 63 75 |nstructu|red docu|
|00001510| 6d 65 6e 74 20 66 69 6c | 65 73 20 28 66 6f 72 20 |ment fil|es (for |
|00001520| 69 6e 73 74 61 6e 63 65 | 2c 20 63 6f 72 72 65 73 |instance|, corres|
|00001530| 70 6f 6e 64 65 6e 63 65 | 2c 20 65 6c 65 63 74 72 |pondence|, electr|
|00001540| 6f 6e 69 63 20 6d 61 69 | 6c 2c 20 61 6e 64 20 72 |onic mai|l, and r|
|00001550| 65 70 6f 72 74 73 29 20 | 74 68 61 74 20 72 65 73 |eports) |that res|
|00001560| 69 64 65 20 6f 6e 20 61 | 6e 20 41 70 70 6c 65 53 |ide on a|n AppleS|
|00001570| 65 61 72 63 68 20 73 65 | 72 76 65 72 2e 20 54 68 |earch se|rver. Th|
|00001580| 69 73 20 64 6f 63 75 6d | 65 6e 74 20 69 73 20 69 |is docum|ent is i|
|00001590| 6e 74 65 6e 64 65 64 20 | 66 6f 72 20 64 65 76 65 |ntended |for deve|
|000015a0| 6c 6f 70 65 72 73 20 77 | 68 6f 20 77 61 6e 74 20 |lopers w|ho want |
|000015b0| 74 6f 20 77 72 69 74 65 | 20 74 68 65 69 72 20 6f |to write| their o|
|000015c0| 77 6e 20 63 75 73 74 6f | 6d 20 41 70 70 6c 65 53 |wn custo|m AppleS|
|000015d0| 65 61 72 63 68 20 63 6c | 69 65 6e 74 20 75 73 65 |earch cl|ient use|
|000015e0| 72 20 69 6e 74 65 72 66 | 61 63 65 20 74 6f 20 74 |r interf|ace to t|
|000015f0| 68 65 20 41 70 70 6c 65 | 53 65 61 72 63 68 20 73 |he Apple|Search s|
|00001600| 65 72 76 65 72 20 6f 72 | 20 77 68 6f 20 77 61 6e |erver or| who wan|
|00001610| 74 20 74 6f 20 69 6e 74 | 65 67 72 61 74 65 20 63 |t to int|egrate c|
|00001620| 65 72 74 61 69 6e 20 66 | 65 61 74 75 72 65 73 20 |ertain f|eatures |
|00001630| 6f 66 20 74 68 65 20 41 | 70 70 6c 65 53 65 61 72 |of the A|ppleSear|
|00001640| 63 68 20 63 6c 69 65 6e | 74 20 73 6f 66 74 77 61 |ch clien|t softwa|
|00001650| 72 65 20 69 6e 74 6f 20 | 74 68 65 69 72 20 6f 77 |re into |their ow|
|00001660| 6e 20 65 78 69 73 74 69 | 6e 67 20 61 70 70 6c 69 |n existi|ng appli|
|00001670| 63 61 74 69 6f 6e 73 2e | 0d 57 68 61 74 20 79 6f |cations.|.What yo|
|00001680| 75 20 6e 65 65 64 20 74 | 6f 20 6b 6e 6f 77 0d 42 |u need t|o know.B|
|00001690| 65 66 6f 72 65 20 79 6f | 75 20 75 73 65 20 74 68 |efore yo|u use th|
|000016a0| 69 73 20 67 75 69 64 65 | 20 79 6f 75 20 73 68 6f |is guide| you sho|
|000016b0| 75 6c 64 20 62 65 20 66 | 61 6d 69 6c 69 61 72 20 |uld be f|amiliar |
|000016c0| 77 69 74 68 20 74 68 65 | 20 41 70 70 6c 65 53 65 |with the| AppleSe|
|000016d0| 61 72 63 68 20 43 6c 69 | 65 6e 74 20 61 6e 64 20 |arch Cli|ent and |
|000016e0| 53 65 72 76 65 72 20 61 | 70 70 6c 69 63 61 74 69 |Server a|pplicati|
|000016f0| 6f 6e 73 2e 20 59 6f 75 | 20 73 68 6f 75 6c 64 20 |ons. You| should |
|00001700| 62 65 20 66 61 6d 69 6c | 69 61 72 20 77 69 74 68 |be famil|iar with|
|00001710| 20 6b 65 79 20 66 65 61 | 74 75 72 65 73 20 6f 66 | key fea|tures of|
|00001720| 20 41 70 70 6c 65 53 65 | 61 72 63 68 20 43 6c 69 | AppleSe|arch Cli|
|00001730| 65 6e 74 20 73 75 63 68 | 20 61 73 20 72 65 70 6f |ent such| as repo|
|00001740| 72 74 65 72 73 2c 20 61 | 72 74 69 63 6c 65 20 72 |rters, a|rticle r|
|00001750| 65 74 72 69 65 76 61 6c | 2c 20 73 63 68 65 64 75 |etrieval|, schedu|
|00001760| 6c 65 64 20 73 65 61 72 | 63 68 65 73 2c 20 61 6e |led sear|ches, an|
|00001770| 64 20 75 70 64 61 74 65 | 73 2e 20 59 6f 75 20 73 |d update|s. You s|
|00001780| 68 6f 75 6c 64 20 61 6c | 73 6f 20 62 65 20 66 61 |hould al|so be fa|
|00001790| 6d 69 6c 69 61 72 20 77 | 69 74 68 20 41 70 70 6c |miliar w|ith Appl|
|000017a0| 65 20 65 76 65 6e 74 73 | 20 61 6e 64 20 6b 6e 6f |e events| and kno|
|000017b0| 77 20 68 6f 77 20 74 6f | 20 70 72 6f 67 72 61 6d |w how to| program|
|000017c0| 20 69 6e 20 74 68 65 20 | 4d 61 63 69 6e 74 6f 73 | in the |Macintos|
|000017d0| 68 20 65 6e 76 69 72 6f | 6e 6d 65 6e 74 2e 20 46 |h enviro|nment. F|
|000017e0| 6f 72 20 69 6e 66 6f 72 | 6d 61 74 69 6f 6e 20 6f |or infor|mation o|
|000017f0| 6e 20 74 68 65 73 65 20 | 73 75 62 6a 65 63 74 73 |n these |subjects|
|00001800| 2c 20 73 65 65 20 74 68 | 65 20 72 65 66 65 72 65 |, see th|e refere|
|00001810| 6e 63 65 73 20 69 6e 20 | d2 53 75 67 67 65 73 74 |nces in |.Suggest|
|00001820| 65 64 20 52 65 61 64 69 | 6e 67 2c d3 20 6c 61 74 |ed Readi|ng,. lat|
|00001830| 65 72 20 69 6e 20 74 68 | 69 73 20 50 72 65 66 61 |er in th|is Prefa|
|00001840| 63 65 2e 0d 57 68 61 74 | 20 74 68 69 73 20 67 75 |ce..What| this gu|
|00001850| 69 64 65 20 63 6f 6e 74 | 61 69 6e 73 0d 48 65 72 |ide cont|ains.Her|
|00001860| 65 20 69 73 20 61 20 64 | 65 73 63 72 69 70 74 69 |e is a d|escripti|
|00001870| 6f 6e 20 6f 66 20 77 68 | 61 74 20 79 6f 75 d5 6c |on of wh|at you.l|
|00001880| 6c 20 66 69 6e 64 20 69 | 6e 20 74 68 69 73 20 67 |l find i|n this g|
|00001890| 75 69 64 65 3a 0d 6d 09 | 43 68 61 70 74 65 72 20 |uide:.m.|Chapter |
|000018a0| 31 2c 20 d2 41 72 63 68 | 69 74 65 63 74 75 72 61 |1, .Arch|itectura|
|000018b0| 6c 20 4f 76 65 72 76 69 | 65 77 2c d3 20 70 72 65 |l Overvi|ew,. pre|
|000018c0| 73 65 6e 74 73 20 61 6e | 20 6f 76 65 72 76 69 65 |sents an| overvie|
|000018d0| 77 20 6f 66 20 74 68 65 | 20 41 70 70 6c 65 53 65 |w of the| AppleSe|
|000018e0| 61 72 63 68 20 63 6c 69 | 65 6e 74 2f 73 65 72 76 |arch cli|ent/serv|
|000018f0| 65 72 20 61 72 63 68 69 | 74 65 63 74 75 72 65 20 |er archi|tecture |
|00001900| 61 6e 64 20 64 65 73 63 | 72 69 62 65 73 20 6b 65 |and desc|ribes ke|
|00001910| 79 20 63 6f 6e 63 65 70 | 74 73 20 6f 66 20 74 68 |y concep|ts of th|
|00001920| 65 20 41 70 70 6c 65 53 | 65 61 72 63 68 20 43 6c |e AppleS|earch Cl|
|00001930| 69 65 6e 74 20 61 70 70 | 6c 69 63 61 74 69 6f 6e |ient app|lication|
|00001940| 20 70 72 6f 67 72 61 6d | 6d 69 6e 67 20 69 6e 74 | program|ming int|
|00001950| 65 72 66 61 63 65 20 28 | 41 50 49 29 2e 0d 6d 09 |erface (|API)..m.|
|00001960| 43 68 61 70 74 65 72 20 | 32 2c 20 d2 41 70 70 6c |Chapter |2, .Appl|
|00001970| 65 20 45 76 65 6e 74 73 | 20 41 70 70 6c 69 63 61 |e Events| Applica|
|00001980| 74 69 6f 6e 20 50 72 6f | 67 72 61 6d 6d 69 6e 67 |tion Pro|gramming|
|00001990| 20 49 6e 74 65 72 66 61 | 63 65 2c d3 20 64 65 73 | Interfa|ce,. des|
|000019a0| 63 72 69 62 65 73 20 68 | 6f 77 20 74 6f 20 75 73 |cribes h|ow to us|
|000019b0| 65 20 74 68 65 20 41 70 | 70 6c 65 20 65 76 65 6e |e the Ap|ple even|
|000019c0| 74 73 20 76 65 72 73 69 | 6f 6e 20 6f 66 20 74 68 |ts versi|on of th|
|000019d0| 65 20 41 50 49 20 61 6e | 64 20 74 68 65 6e 20 67 |e API an|d then g|
|000019e0| 69 76 65 73 20 61 20 64 | 65 74 61 69 6c 65 64 20 |ives a d|etailed |
|000019f0| 73 70 65 63 69 66 69 63 | 61 74 69 6f 6e 20 6f 66 |specific|ation of|
|00001a00| 20 65 61 63 68 20 41 70 | 70 6c 65 20 65 76 65 6e | each Ap|ple even|
|00001a10| 74 2e 0d 6d 09 43 68 61 | 70 74 65 72 20 33 2c 20 |t..m.Cha|pter 3, |
|00001a20| d2 43 20 4c 69 62 72 61 | 72 79 20 41 70 70 6c 69 |.C Libra|ry Appli|
|00001a30| 63 61 74 69 6f 6e 20 50 | 72 6f 67 72 61 6d 6d 69 |cation P|rogrammi|
|00001a40| 6e 67 20 49 6e 74 65 72 | 66 61 63 65 2c d3 20 64 |ng Inter|face,. d|
|00001a50| 65 73 63 72 69 62 65 73 | 20 68 6f 77 20 74 6f 20 |escribes| how to |
|00001a60| 75 73 65 20 74 68 65 20 | 43 20 41 50 49 20 61 6e |use the |C API an|
|00001a70| 64 20 74 68 65 6e 20 67 | 69 76 65 73 20 61 20 64 |d then g|ives a d|
|00001a80| 65 74 61 69 6c 65 64 20 | 64 65 73 63 72 69 70 74 |etailed |descript|
|00001a90| 69 6f 6e 20 6f 66 20 65 | 61 63 68 20 43 20 66 75 |ion of e|ach C fu|
|00001aa0| 6e 63 74 69 6f 6e 20 63 | 61 6c 6c 2e 0d 6d 09 41 |nction c|all..m.A|
|00001ab0| 70 70 65 6e 64 69 78 20 | 41 2c 20 d2 43 6f 6e 73 |ppendix |A, .Cons|
|00001ac0| 74 61 6e 74 73 20 61 6e | 64 20 45 72 72 6f 72 73 |tants an|d Errors|
|00001ad0| 2c d3 20 70 72 65 73 65 | 6e 74 73 20 61 20 73 75 |,. prese|nts a su|
|00001ae0| 6d 6d 61 72 79 20 6f 66 | 20 41 70 70 6c 65 53 65 |mmary of| AppleSe|
|00001af0| 61 72 63 68 20 41 50 49 | 20 65 72 72 6f 72 73 20 |arch API| errors |
|00001b00| 61 6e 64 20 72 65 6c 61 | 74 65 64 20 63 6f 6e 73 |and rela|ted cons|
|00001b10| 74 61 6e 74 73 2e 0d 6d | 09 41 70 70 65 6e 64 69 |tants..m|.Appendi|
|00001b20| 78 20 42 2c 20 d2 41 70 | 70 6c 65 20 45 76 65 6e |x B, .Ap|ple Even|
|00001b30| 74 73 20 53 75 6d 6d 61 | 72 79 2c d3 20 70 72 65 |ts Summa|ry,. pre|
|00001b40| 73 65 6e 74 73 20 61 20 | 73 75 6d 6d 61 72 79 20 |sents a |summary |
|00001b50| 6f 66 20 74 68 65 20 41 | 70 70 6c 65 20 65 76 65 |of the A|pple eve|
|00001b60| 6e 74 73 20 41 50 49 2e | 0d 6d 09 41 70 70 65 6e |nts API.|.m.Appen|
|00001b70| 64 69 78 20 43 2c 20 d2 | 43 20 4c 69 62 72 61 72 |dix C, .|C Librar|
|00001b80| 79 20 53 75 6d 6d 61 72 | 79 2c d3 20 70 72 65 73 |y Summar|y,. pres|
|00001b90| 65 6e 74 73 20 61 20 73 | 75 6d 6d 61 72 79 20 6f |ents a s|ummary o|
|00001ba0| 66 20 74 68 65 20 43 20 | 4c 69 62 72 61 72 79 20 |f the C |Library |
|00001bb0| 41 50 49 2e 0d 43 6f 6e | 76 65 6e 74 69 6f 6e 73 |API..Con|ventions|
|00001bc0| 20 75 73 65 64 20 69 6e | 20 74 68 69 73 20 67 75 | used in| this gu|
|00001bd0| 69 64 65 0d 54 68 65 20 | 43 6f 75 72 69 65 72 20 |ide.The |Courier |
|00001be0| 66 6f 6e 74 20 69 73 20 | 75 73 65 64 20 66 6f 72 |font is |used for|
|00001bf0| 20 65 76 65 6e 74 20 63 | 6c 61 73 73 65 73 2c 20 | event c|lasses, |
|00001c00| 65 76 65 6e 74 20 49 44 | 73 2c 20 70 61 72 61 6d |event ID|s, param|
|00001c10| 65 74 65 72 73 2c 20 6b | 65 79 77 6f 72 64 73 2c |eters, k|eywords,|
|00001c20| 20 61 6e 64 20 72 65 73 | 75 6c 74 20 63 6f 64 65 | and res|ult code|
|00001c30| 20 6d 65 73 73 61 67 65 | 73 2e 20 54 68 69 73 20 | message|s. This |
|00001c40| 66 6f 6e 74 20 69 73 20 | 61 6c 73 6f 20 75 73 65 |font is |also use|
|00001c50| 64 20 74 6f 20 69 6e 64 | 69 63 61 74 65 20 63 6f |d to ind|icate co|
|00001c60| 64 65 20 65 6c 65 6d 65 | 6e 74 73 20 74 68 61 74 |de eleme|nts that|
|00001c70| 20 6d 75 73 74 20 62 65 | 20 74 79 70 65 64 20 69 | must be| typed i|
|00001c80| 6e 74 6f 20 79 6f 75 72 | 20 70 72 6f 67 72 61 6d |nto your| program|
|00001c90| 2e 0d 46 6f 72 6d 61 74 | 20 6f 66 20 41 50 49 20 |..Format| of API |
|00001ca0| 64 65 73 63 72 69 70 74 | 69 6f 6e 73 0d 54 68 65 |descript|ions.The|
|00001cb0| 20 64 65 73 63 72 69 70 | 74 69 6f 6e 20 6f 66 20 | descrip|tion of |
|00001cc0| 65 61 63 68 20 41 70 70 | 6c 65 20 65 76 65 6e 74 |each App|le event|
|00001cd0| 20 41 50 49 20 63 6f 6e | 74 61 69 6e 73 20 74 68 | API con|tains th|
|00001ce0| 65 20 66 69 6e 66 6f 72 | 6d 61 74 69 6f 6e 20 73 |e finfor|mation s|
|00001cf0| 68 6f 77 6e 20 69 6e 20 | 74 68 65 20 66 6f 6c 6c |hown in |the foll|
|00001d00| 6f 77 69 6e 67 20 66 69 | 67 75 72 65 3a 0d 54 68 |owing fi|gure:.Th|
|00001d10| 65 20 64 65 73 63 72 69 | 70 74 69 6f 6e 20 6f 66 |e descri|ption of|
|00001d20| 20 65 61 63 68 20 43 20 | 4c 69 62 72 61 72 79 20 | each C |Library |
|00001d30| 41 50 49 20 63 6f 6e 74 | 61 69 6e 73 20 74 68 65 |API cont|ains the|
|00001d40| 20 66 69 6e 66 6f 72 6d | 61 74 69 6f 6e 20 73 68 | finform|ation sh|
|00001d50| 6f 77 6e 20 69 6e 20 74 | 68 65 20 66 6f 6c 6c 6f |own in t|he follo|
|00001d60| 77 69 6e 67 20 66 69 67 | 75 72 65 3a 0d 41 62 6f |wing fig|ure:.Abo|
|00001d70| 75 74 20 74 68 65 20 41 | 70 70 6c 65 53 65 61 72 |ut the A|ppleSear|
|00001d80| 63 68 20 43 6c 69 65 6e | 74 20 44 65 76 65 6c 6f |ch Clien|t Develo|
|00001d90| 70 65 72 d5 73 20 4b 69 | 74 0d 54 68 69 73 20 6d |per.s Ki|t.This m|
|00001da0| 61 6e 75 61 6c 2c 20 74 | 68 65 20 41 70 70 6c 65 |anual, t|he Apple|
|00001db0| 53 65 61 72 63 68 20 43 | 6c 69 65 6e 74 20 44 65 |Search C|lient De|
|00001dc0| 76 65 6c 6f 70 65 72 d5 | 73 20 47 75 69 64 65 2c |veloper.|s Guide,|
|00001dd0| 20 69 73 20 6a 75 73 74 | 20 6f 6e 65 20 63 6f 6d | is just| one com|
|00001de0| 70 6f 6e 65 6e 74 20 69 | 6e 20 74 68 65 20 41 70 |ponent i|n the Ap|
|00001df0| 70 6c 65 53 65 61 72 63 | 68 20 43 6c 69 65 6e 74 |pleSearc|h Client|
|00001e00| 20 44 65 76 65 6c 6f 70 | 65 72 d5 73 20 4b 69 74 | Develop|er.s Kit|
|00001e10| 2e 20 54 68 65 20 6b 69 | 74 20 61 6c 73 6f 20 69 |. The ki|t also i|
|00001e20| 6e 63 6c 75 64 65 73 20 | 74 68 65 20 66 6f 6c 6c |ncludes |the foll|
|00001e30| 6f 77 69 6e 67 20 69 74 | 65 6d 73 3a 0d 6d 09 41 |owing it|ems:.m.A|
|00001e40| 70 70 6c 65 53 65 61 72 | 63 68 20 63 6c 69 65 6e |ppleSear|ch clien|
|00001e50| 74 20 73 6f 66 74 77 61 | 72 65 0d 6d 09 61 20 43 |t softwa|re.m.a C|
|00001e60| 20 4c 69 62 72 61 72 79 | 20 6f 62 6a 65 63 74 20 | Library| object |
|00001e70| 66 69 6c 65 0d 6d 09 68 | 65 61 64 65 72 20 66 69 |file.m.h|eader fi|
|00001e80| 6c 65 73 20 66 6f 72 20 | 74 68 65 20 43 20 4c 69 |les for |the C Li|
|00001e90| 62 72 61 72 79 20 61 6e | 64 20 41 70 70 6c 65 20 |brary an|d Apple |
|00001ea0| 65 76 65 6e 74 73 0d 6d | 09 61 6e 20 41 70 70 6c |events.m|.an Appl|
|00001eb0| 65 20 65 76 65 6e 74 73 | 20 74 6f 6f 6c 20 74 68 |e events| tool th|
|00001ec0| 61 74 20 61 6c 6c 6f 77 | 73 20 79 6f 75 20 74 6f |at allow|s you to|
|00001ed0| 20 6c 6f 67 20 41 70 70 | 6c 65 20 65 76 65 6e 74 | log App|le event|
|00001ee0| 20 61 63 74 69 76 69 74 | 79 20 6f 6e 20 79 6f 75 | activit|y on you|
|00001ef0| 72 20 73 79 73 74 65 6d | 0d 6d 09 73 61 6d 70 6c |r system|.m.sampl|
|00001f00| 65 20 63 6f 64 65 20 61 | 6e 64 20 61 20 53 69 6d |e code a|nd a Sim|
|00001f10| 70 6c 65 54 65 78 74 20 | 66 69 6c 65 20 74 68 61 |pleText |file tha|
|00001f20| 74 20 65 78 70 6c 61 69 | 6e 73 20 68 6f 77 20 74 |t explai|ns how t|
|00001f30| 68 65 20 73 61 6d 70 6c | 65 20 63 6f 64 65 20 66 |he sampl|e code f|
|00001f40| 75 6e 63 74 69 6f 6e 73 | 0d 6d 09 74 68 65 20 41 |unctions|.m.the A|
|00001f50| 70 70 6c 65 53 65 61 72 | 63 68 20 55 70 64 61 74 |ppleSear|ch Updat|
|00001f60| 65 20 46 69 6c 65 20 46 | 6f 72 6d 61 74 20 44 65 |e File F|ormat De|
|00001f70| 76 65 6c 6f 70 65 72 d5 | 73 20 4b 69 74 2c 20 77 |veloper.|s Kit, w|
|00001f80| 68 69 63 68 20 69 6e 63 | 6c 75 64 65 73 20 74 68 |hich inc|ludes th|
|00001f90| 65 20 41 70 70 6c 65 53 | 65 61 72 63 68 20 55 70 |e AppleS|earch Up|
|00001fa0| 64 61 74 65 20 46 69 6c | 65 20 46 6f 72 6d 61 74 |date Fil|e Format|
|00001fb0| 20 52 65 66 65 72 65 6e | 63 65 20 61 6e 64 20 61 | Referen|ce and a|
|00001fc0| 20 73 65 74 20 6f 66 20 | 75 74 69 6c 69 74 79 20 | set of |utility |
|00001fd0| 72 6f 75 74 69 6e 65 73 | 0d 41 66 74 65 72 20 79 |routines|.After y|
|00001fe0| 6f 75 20 72 65 61 64 20 | 74 68 69 73 20 67 75 69 |ou read |this gui|
|00001ff0| 64 65 2c 20 72 65 66 65 | 72 20 74 6f 20 74 68 65 |de, refe|r to the|
|00002000| 20 41 70 70 6c 65 53 65 | 61 72 63 68 20 55 70 64 | AppleSe|arch Upd|
|00002010| 61 74 65 20 46 69 6c 65 | 20 46 6f 72 6d 61 74 20 |ate File| Format |
|00002020| 52 65 66 65 72 65 6e 63 | 65 20 66 6f 72 20 69 6e |Referenc|e for in|
|00002030| 66 6f 72 6d 61 74 69 6f | 6e 20 61 62 6f 75 74 20 |formatio|n about |
|00002040| 74 68 65 20 66 6f 72 6d | 61 74 20 6f 66 20 41 70 |the form|at of Ap|
|00002050| 70 6c 65 53 65 61 72 63 | 68 2d 67 65 6e 65 72 61 |pleSearc|h-genera|
|00002060| 74 65 64 20 75 70 64 61 | 74 65 20 64 6f 63 75 6d |ted upda|te docum|
|00002070| 65 6e 74 73 2e 0d 4e 6f | 74 65 3a 20 20 49 6e 20 |ents..No|te: In |
|00002080| 6f 72 64 65 72 20 74 6f | 20 74 65 73 74 20 61 6e |order to| test an|
|00002090| 64 20 75 73 65 20 74 68 | 65 20 41 70 70 6c 65 53 |d use th|e AppleS|
|000020a0| 65 61 72 63 68 20 63 6c | 69 65 6e 74 20 63 61 70 |earch cl|ient cap|
|000020b0| 61 62 69 6c 69 74 79 2c | 20 79 6f 75 20 6d 75 73 |ability,| you mus|
|000020c0| 74 20 70 75 72 63 68 61 | 73 65 20 74 68 65 20 41 |t purcha|se the A|
|000020d0| 70 70 6c 65 53 65 61 72 | 63 68 20 73 65 72 76 65 |ppleSear|ch serve|
|000020e0| 72 20 73 6f 66 74 77 61 | 72 65 2e 0d 53 75 67 67 |r softwa|re..Sugg|
|000020f0| 65 73 74 65 64 20 72 65 | 61 64 69 6e 67 0d 48 65 |ested re|ading.He|
|00002100| 72 65 20 69 73 20 61 20 | 6c 69 73 74 20 6f 66 20 |re is a |list of |
|00002110| 72 65 66 65 72 65 6e 63 | 65 20 6d 61 74 65 72 69 |referenc|e materi|
|00002120| 61 6c 73 20 74 68 61 74 | 20 79 6f 75 20 6d 61 79 |als that| you may|
|00002130| 20 66 69 6e 64 20 68 65 | 6c 70 66 75 6c 3a 0d 6d | find he|lpful:.m|
|00002140| 09 41 70 70 6c 65 53 65 | 61 72 63 68 20 55 73 65 |.AppleSe|arch Use|
|00002150| 72 d5 73 20 47 75 69 64 | 65 20 28 69 6e 63 6c 75 |r.s Guid|e (inclu|
|00002160| 64 65 64 20 69 6e 20 74 | 68 65 20 41 70 70 6c 65 |ded in t|he Apple|
|00002170| 53 65 61 72 63 68 20 53 | 65 72 76 65 72 20 61 6e |Search S|erver an|
|00002180| 64 20 43 6c 69 65 6e 74 | 20 66 6f 72 20 4d 61 63 |d Client| for Mac|
|00002190| 69 6e 74 6f 73 68 2c 20 | 76 65 72 73 69 6f 6e 20 |intosh, |version |
|000021a0| 31 2e 35 29 20 64 65 73 | 63 72 69 62 65 73 20 68 |1.5) des|cribes h|
|000021b0| 6f 77 20 74 6f 20 75 73 | 65 20 74 68 65 20 41 70 |ow to us|e the Ap|
|000021c0| 70 6c 65 53 65 61 72 63 | 68 20 63 6c 69 65 6e 74 |pleSearc|h client|
|000021d0| 20 74 6f 20 73 65 61 72 | 63 68 20 66 6f 72 20 61 | to sear|ch for a|
|000021e0| 6e 64 20 72 65 74 72 69 | 65 76 65 20 69 6e 66 6f |nd retri|eve info|
|000021f0| 72 6d 61 74 69 6f 6e 2e | 20 0d 6d 09 41 70 70 6c |rmation.| .m.Appl|
|00002200| 65 53 65 61 72 63 68 20 | 41 64 6d 69 6e 69 73 74 |eSearch |Administ|
|00002210| 72 61 74 6f 72 d5 73 20 | 47 75 69 64 65 20 28 69 |rator.s |Guide (i|
|00002220| 6e 63 6c 75 64 65 64 20 | 69 6e 20 74 68 65 20 41 |ncluded |in the A|
|00002230| 70 70 6c 65 53 65 61 72 | 63 68 20 53 65 72 76 65 |ppleSear|ch Serve|
|00002240| 72 20 61 6e 64 20 43 6c | 69 65 6e 74 20 66 6f 72 |r and Cl|ient for|
|00002250| 20 4d 61 63 69 6e 74 6f | 73 68 2c 20 76 65 72 73 | Macinto|sh, vers|
|00002260| 69 6f 6e 20 31 2e 35 29 | 20 64 65 73 63 72 69 62 |ion 1.5)| describ|
|00002270| 65 73 20 68 6f 77 20 74 | 6f 20 73 65 74 20 75 70 |es how t|o set up|
|00002280| 20 61 6e 64 20 6d 61 69 | 6e 74 61 69 6e 20 61 6e | and mai|ntain an|
|00002290| 20 41 70 70 6c 65 53 65 | 61 72 63 68 20 53 65 72 | AppleSe|arch Ser|
|000022a0| 76 65 72 2e 0d 6d 09 41 | 70 70 6c 65 53 65 61 72 |ver..m.A|ppleSear|
|000022b0| 63 68 20 55 70 64 61 74 | 65 20 46 69 6c 65 20 46 |ch Updat|e File F|
|000022c0| 6f 72 6d 61 74 20 52 65 | 66 65 72 65 6e 63 65 20 |ormat Re|ference |
|000022d0| 28 69 6e 63 6c 75 64 65 | 64 20 69 6e 20 74 68 65 |(include|d in the|
|000022e0| 20 41 70 70 6c 65 53 65 | 61 72 63 68 20 46 69 6c | AppleSe|arch Fil|
|000022f0| 65 20 46 6f 72 6d 61 74 | 20 44 65 76 65 6c 6f 70 |e Format| Develop|
|00002300| 65 72 d5 73 20 4b 69 74 | 2c 20 77 68 69 63 68 20 |er.s Kit|, which |
|00002310| 69 73 20 69 6e 20 74 68 | 65 20 41 70 70 6c 65 53 |is in th|e AppleS|
|00002320| 65 61 72 63 68 20 43 6c | 69 65 6e 74 20 44 65 76 |earch Cl|ient Dev|
|00002330| 65 6c 6f 70 65 72 d5 73 | 20 4b 69 74 29 20 64 65 |eloper.s| Kit) de|
|00002340| 73 63 72 69 62 65 73 20 | 74 68 65 20 66 6f 72 6d |scribes |the form|
|00002350| 61 74 20 6f 66 20 41 70 | 70 6c 65 53 65 61 72 63 |at of Ap|pleSearc|
|00002360| 68 2d 67 65 6e 65 72 61 | 74 65 64 20 75 70 64 61 |h-genera|ted upda|
|00002370| 74 65 20 64 6f 63 75 6d | 65 6e 74 73 2e 0d 6d 09 |te docum|ents..m.|
|00002380| 49 6e 73 69 64 65 20 4d | 61 63 69 6e 74 6f 73 68 |Inside M|acintosh|
|00002390| 3a 20 49 6e 74 65 72 61 | 70 70 6c 69 63 61 74 69 |: Intera|pplicati|
|000023a0| 6f 6e 20 43 6f 6d 6d 75 | 6e 69 63 61 74 69 6f 6e |on Commu|nication|
|000023b0| 20 70 72 6f 76 69 64 65 | 73 20 61 20 63 6f 6d 70 | provide|s a comp|
|000023c0| 6c 65 74 65 20 64 65 73 | 63 72 69 70 74 69 6f 6e |lete des|cription|
|000023d0| 20 6f 66 20 41 70 70 6c | 65 20 65 76 65 6e 74 73 | of Appl|e events|
|000023e0| 2c 20 65 78 70 6c 61 69 | 6e 73 20 68 6f 77 20 74 |, explai|ns how t|
|000023f0| 6f 20 73 65 6e 64 20 61 | 6e 64 20 72 65 63 65 69 |o send a|nd recei|
|00002400| 76 65 20 41 70 70 6c 65 | 20 65 76 65 6e 74 73 2c |ve Apple| events,|
|00002410| 20 61 6e 64 20 69 6e 63 | 6c 75 64 65 73 20 72 65 | and inc|ludes re|
|00002420| 66 65 72 65 6e 63 65 20 | 69 6e 66 6f 72 6d 61 74 |ference |informat|
|00002430| 69 6f 6e 20 66 6f 72 20 | 61 6c 6c 20 41 70 70 6c |ion for |all Appl|
|00002440| 65 20 45 76 65 6e 74 20 | 4d 61 6e 61 67 65 72 20 |e Event |Manager |
|00002450| 72 6f 75 74 69 6e 65 73 | 2e 20 49 6e 73 69 64 65 |routines|. Inside|
|00002460| 20 4d 61 63 69 6e 74 6f | 73 68 3a 20 49 6e 74 65 | Macinto|sh: Inte|
|00002470| 72 61 70 70 6c 69 63 61 | 74 69 6f 6e 20 43 6f 6d |rapplica|tion Com|
|00002480| 6d 75 6e 69 63 61 74 69 | 6f 6e 20 28 41 64 64 69 |municati|on (Addi|
|00002490| 73 6f 6e 2d 57 65 73 6c | 65 79 20 50 75 62 6c 69 |son-Wesl|ey Publi|
|000024a0| 73 68 69 6e 67 20 43 6f | 2e 2c 20 31 39 39 33 29 |shing Co|., 1993)|
|000024b0| 20 69 73 20 61 76 61 69 | 6c 61 62 6c 65 20 69 6e | is avai|lable in|
|000024c0| 20 62 6f 6f 6b 73 74 6f | 72 65 73 2e 0d 6d 09 49 | booksto|res..m.I|
|000024d0| 6e 73 69 64 65 20 4d 61 | 63 69 6e 74 6f 73 68 3a |nside Ma|cintosh:|
|000024e0| 20 50 72 6f 63 65 73 73 | 65 73 20 70 72 6f 76 69 | Process|es provi|
|000024f0| 64 65 73 20 62 61 63 6b | 67 72 6f 75 6e 64 20 69 |des back|ground i|
|00002500| 6e 66 6f 72 6d 61 74 69 | 6f 6e 20 6f 6e 20 74 68 |nformati|on on th|
|00002510| 65 20 70 61 72 74 73 20 | 6f 66 20 74 68 65 20 4d |e parts |of the M|
|00002520| 61 63 69 6e 74 6f 73 68 | 20 4f 70 65 72 61 74 69 |acintosh| Operati|
|00002530| 6e 67 20 53 79 73 74 65 | 6d 20 74 68 61 74 20 61 |ng Syste|m that a|
|00002540| 6c 6c 6f 77 20 79 6f 75 | 20 74 6f 20 6d 61 6e 61 |llow you| to mana|
|00002550| 67 65 20 70 72 6f 63 65 | 73 73 65 73 20 61 6e 64 |ge proce|sses and|
|00002560| 20 74 61 73 6b 73 2e 20 | 49 6e 73 69 64 65 20 4d | tasks. |Inside M|
|00002570| 61 63 69 6e 74 6f 73 68 | 3a 20 50 72 6f 63 65 73 |acintosh|: Proces|
|00002580| 73 65 73 20 28 41 64 64 | 69 73 6f 6e 2d 57 65 73 |ses (Add|ison-Wes|
|00002590| 6c 65 79 20 50 75 62 6c | 69 73 68 69 6e 67 20 43 |ley Publ|ishing C|
|000025a0| 6f 2e 2c 20 31 39 39 32 | 29 20 69 73 20 61 76 61 |o., 1992|) is ava|
|000025b0| 69 6c 61 62 6c 65 20 69 | 6e 20 62 6f 6f 6b 73 74 |ilable i|n bookst|
|000025c0| 6f 72 65 73 2e 0d 53 6f | 66 74 77 61 72 65 20 6c |ores..So|ftware l|
|000025d0| 69 63 65 6e 73 69 6e 67 | 0d 46 6f 72 20 69 6e 66 |icensing|.For inf|
|000025e0| 6f 72 6d 61 74 69 6f 6e | 20 6f 6e 20 64 65 76 65 |ormation| on deve|
|000025f0| 6c 6f 70 65 72 20 6c 69 | 63 65 6e 73 69 6e 67 2c |loper li|censing,|
|00002600| 20 70 6c 65 61 73 65 20 | 63 6f 6e 74 61 63 74 20 | please |contact |
|00002610| 74 68 65 20 53 6f 66 74 | 77 61 72 65 20 4c 69 63 |the Soft|ware Lic|
|00002620| 65 6e 73 69 6e 67 20 44 | 65 70 61 72 74 6d 65 6e |ensing D|epartmen|
|00002630| 74 3a 0d 53 6f 66 74 77 | 61 72 65 20 4c 69 63 65 |t:.Softw|are Lice|
|00002640| 6e 73 69 6e 67 20 44 65 | 70 61 72 74 6d 65 6e 74 |nsing De|partment|
|00002650| 0d 41 70 70 6c 65 20 43 | 6f 6d 70 75 74 65 72 2c |.Apple C|omputer,|
|00002660| 20 49 6e 63 2e 0d 32 34 | 32 30 20 52 69 64 67 65 | Inc..24|20 Ridge|
|00002670| 70 6f 69 6e 74 20 44 72 | 69 76 65 2c 20 4d 2f 53 |point Dr|ive, M/S|
|00002680| 20 31 39 38 2d 53 57 4c | 0d 41 75 73 74 69 6e 2c | 198-SWL|.Austin,|
|00002690| 20 54 58 20 37 38 37 35 | 34 0d 55 2e 53 2e 41 2e | TX 7875|4.U.S.A.|
|000026a0| 0d 54 65 6c 65 70 68 6f | 6e 65 3a 20 28 35 31 32 |.Telepho|ne: (512|
|000026b0| 29 20 39 31 39 2d 32 36 | 34 35 0d 41 70 70 6c 65 |) 919-26|45.Apple|
|000026c0| 4c 69 6e 6b 3a 20 53 57 | 2e 4c 49 43 45 4e 53 45 |Link: SW|.LICENSE|
|000026d0| 0d 0d 0d 31 09 41 72 63 | 68 69 74 65 63 74 75 72 |...1.Arc|hitectur|
|000026e0| 61 6c 20 4f 76 65 72 76 | 69 65 77 0d 54 68 69 73 |al Overv|iew.This|
|000026f0| 20 63 68 61 70 74 65 72 | 20 70 72 65 73 65 6e 74 | chapter| present|
|00002700| 73 20 61 6e 20 6f 76 65 | 72 76 69 65 77 20 6f 66 |s an ove|rview of|
|00002710| 20 74 68 65 20 41 70 70 | 6c 65 53 65 61 72 63 68 | the App|leSearch|
|00002720| 20 63 6c 69 65 6e 74 2f | 73 65 72 76 65 72 20 61 | client/|server a|
|00002730| 72 63 68 69 74 65 63 74 | 75 72 65 20 61 6e 64 20 |rchitect|ure and |
|00002740| 64 65 73 63 72 69 62 65 | 73 20 6b 65 79 20 63 6f |describe|s key co|
|00002750| 6e 63 65 70 74 73 20 72 | 65 71 75 69 72 65 64 20 |ncepts r|equired |
|00002760| 74 6f 20 75 73 65 20 74 | 68 65 20 41 70 70 6c 65 |to use t|he Apple|
|00002770| 53 65 61 72 63 68 20 43 | 6c 69 65 6e 74 20 61 70 |Search C|lient ap|
|00002780| 70 6c 69 63 61 74 69 6f | 6e 20 70 72 6f 67 72 61 |plicatio|n progra|
|00002790| 6d 6d 69 6e 67 20 69 6e | 74 65 72 66 61 63 65 20 |mming in|terface |
|000027a0| 28 41 50 49 29 2e 0d 41 | 70 70 6c 65 53 65 61 72 |(API)..A|ppleSear|
|000027b0| 63 68 20 73 6f 66 74 77 | 61 72 65 20 63 6f 6d 70 |ch softw|are comp|
|000027c0| 6f 6e 65 6e 74 73 0d 41 | 70 70 6c 65 53 65 61 72 |onents.A|ppleSear|
|000027d0| 63 68 20 43 6c 69 65 6e | 74 20 63 6f 6e 73 69 73 |ch Clien|t consis|
|000027e0| 74 73 20 6f 66 20 74 68 | 72 65 65 20 63 6f 6d 70 |ts of th|ree comp|
|000027f0| 6f 6e 65 6e 74 73 3a 20 | 0d 6d 09 41 70 70 6c 65 |onents: |.m.Apple|
|00002800| 53 65 61 72 63 68 20 55 | 73 65 72 20 49 6e 74 65 |Search U|ser Inte|
|00002810| 72 66 61 63 65 20 61 70 | 70 6c 69 63 61 74 69 6f |rface ap|plicatio|
|00002820| 6e 20 0d 6d 09 41 70 70 | 6c 65 53 65 61 72 63 68 |n .m.App|leSearch|
|00002830| 20 43 6f 6d 6d 75 6e 69 | 63 61 74 69 6f 6e 20 45 | Communi|cation E|
|00002840| 78 74 65 6e 73 69 6f 6e | d1 74 68 65 20 62 61 63 |xtension|.the bac|
|00002850| 6b 67 72 6f 75 6e 64 20 | 74 61 73 6b 20 61 70 70 |kground |task app|
|00002860| 6c 69 63 61 74 69 6f 6e | 20 0d 6d 09 41 70 70 6c |lication| .m.Appl|
|00002870| 65 53 65 61 72 63 68 20 | 41 75 74 68 65 6e 74 69 |eSearch |Authenti|
|00002880| 63 61 74 69 6f 6e 20 45 | 78 74 65 6e 73 69 6f 6e |cation E|xtension|
|00002890| d1 74 68 65 20 6c 6f 67 | 2d 6f 6e 20 61 70 70 6c |.the log|-on appl|
|000028a0| 69 63 61 74 69 6f 6e 20 | 0d 54 68 65 20 66 6f 6c |ication |.The fol|
|000028b0| 6c 6f 77 69 6e 67 20 64 | 69 61 67 72 61 6d 20 73 |lowing d|iagram s|
|000028c0| 68 6f 77 73 20 74 68 65 | 20 72 65 6c 61 74 69 6f |hows the| relatio|
|000028d0| 6e 73 68 69 70 73 20 61 | 6d 6f 6e 67 20 74 68 65 |nships a|mong the|
|000028e0| 73 65 20 63 6f 6d 70 6f | 6e 65 6e 74 73 20 61 6e |se compo|nents an|
|000028f0| 64 20 62 65 74 77 65 65 | 6e 20 74 68 65 20 63 6c |d betwee|n the cl|
|00002900| 69 65 6e 74 20 61 6e 64 | 20 74 68 65 20 41 70 70 |ient and| the App|
|00002910| 6c 65 53 65 61 72 63 68 | 20 73 65 72 76 65 72 20 |leSearch| server |
|00002920| 73 6f 66 74 77 61 72 65 | 2e 0d 20 0d 54 68 65 20 |software|.. .The |
|00002930| 41 70 70 6c 65 53 65 61 | 72 63 68 20 55 73 65 72 |AppleSea|rch User|
|00002940| 20 49 6e 74 65 72 66 61 | 63 65 20 61 70 70 6c 69 | Interfa|ce appli|
|00002950| 63 61 74 69 6f 6e 20 69 | 73 20 61 20 4d 61 63 41 |cation i|s a MacA|
|00002960| 70 70 20 33 2e 30 d0 62 | 61 73 65 64 20 4d 61 63 |pp 3.0.b|ased Mac|
|00002970| 69 6e 74 6f 73 68 20 61 | 70 70 6c 69 63 61 74 69 |intosh a|pplicati|
|00002980| 6f 6e 20 74 68 61 74 20 | 70 72 6f 76 69 64 65 73 |on that |provides|
|00002990| 20 74 68 65 20 75 73 65 | 72 20 69 6e 74 65 72 66 | the use|r interf|
|000029a0| 61 63 65 20 66 75 6e 63 | 74 69 6f 6e 61 6c 69 74 |ace func|tionalit|
|000029b0| 79 20 6f 66 20 74 68 65 | 20 63 6c 69 65 6e 74 2e |y of the| client.|
|000029c0| 20 54 68 69 73 20 69 73 | 20 74 68 65 20 6f 6e 6c | This is| the onl|
|000029d0| 79 20 6f 6e 65 20 6f 66 | 20 74 68 65 20 74 68 72 |y one of| the thr|
|000029e0| 65 65 20 63 6f 6d 70 6f | 6e 65 6e 74 73 20 74 68 |ee compo|nents th|
|000029f0| 61 74 20 63 61 6e 20 62 | 65 20 6c 61 75 6e 63 68 |at can b|e launch|
|00002a00| 65 64 20 62 79 20 74 68 | 65 20 75 73 65 72 2e 20 |ed by th|e user. |
|00002a10| 0d 54 68 65 20 41 70 70 | 6c 65 53 65 61 72 63 68 |.The App|leSearch|
|00002a20| 20 43 6f 6d 6d 75 6e 69 | 63 61 74 69 6f 6e 20 45 | Communi|cation E|
|00002a30| 78 74 65 6e 73 69 6f 6e | 20 68 61 73 20 6e 6f 20 |xtension| has no |
|00002a40| 6d 65 6e 75 73 20 61 6e | 64 20 63 61 6e 6e 6f 74 |menus an|d cannot|
|00002a50| 20 64 69 73 70 6c 61 79 | 20 61 6e 79 20 77 69 6e | display| any win|
|00002a60| 64 6f 77 73 2e 20 42 65 | 63 61 75 73 65 20 74 68 |dows. Be|cause th|
|00002a70| 69 73 20 65 78 74 65 6e | 73 69 6f 6e 20 72 75 6e |is exten|sion run|
|00002a80| 73 20 69 6e 20 74 68 65 | 20 62 61 63 6b 67 72 6f |s in the| backgro|
|00002a90| 75 6e 64 2c 20 67 65 6e | 65 72 61 74 69 6e 67 20 |und, gen|erating |
|00002aa0| 75 70 64 61 74 65 20 66 | 69 6c 65 73 20 61 74 20 |update f|iles at |
|00002ab0| 64 65 6c 69 76 65 72 79 | 20 74 69 6d 65 2c 20 74 |delivery| time, t|
|00002ac0| 68 65 20 75 73 65 72 20 | 64 6f 65 73 20 6e 6f 74 |he user |does not|
|00002ad0| 20 68 61 76 65 20 74 6f | 20 6b 65 65 70 20 74 68 | have to| keep th|
|00002ae0| 65 20 75 73 65 72 20 69 | 6e 74 65 72 66 61 63 65 |e user i|nterface|
|00002af0| 20 61 70 70 6c 69 63 61 | 74 69 6f 6e 20 72 75 6e | applica|tion run|
|00002b00| 6e 69 6e 67 20 69 6e 20 | 6f 72 64 65 72 20 74 6f |ning in |order to|
|00002b10| 20 72 65 63 65 69 76 65 | 20 75 70 64 61 74 65 73 | receive| updates|
|00002b20| 2e 20 54 68 65 20 41 70 | 70 6c 65 53 65 61 72 63 |. The Ap|pleSearc|
|00002b30| 68 20 43 6f 6d 6d 75 6e | 69 63 61 74 69 6f 6e 20 |h Commun|ication |
|00002b40| 45 78 74 65 6e 73 69 6f | 6e 20 69 73 20 72 65 73 |Extensio|n is res|
|00002b50| 70 6f 6e 73 69 62 6c 65 | 20 66 6f 72 20 63 6f 6d |ponsible| for com|
|00002b60| 6d 75 6e 69 63 61 74 69 | 6e 67 20 77 69 74 68 20 |municati|ng with |
|00002b70| 74 68 65 20 41 70 70 6c | 65 53 65 61 72 63 68 20 |the Appl|eSearch |
|00002b80| 73 65 72 76 65 72 3b 20 | 74 68 75 73 20 74 68 65 |server; |thus the|
|00002b90| 20 75 73 65 72 20 63 61 | 6e 20 70 65 72 66 6f 72 | user ca|n perfor|
|00002ba0| 6d 20 6f 70 65 72 61 74 | 69 6f 6e 73 20 73 75 63 |m operat|ions suc|
|00002bb0| 68 20 61 73 20 72 65 70 | 6f 72 74 65 72 20 63 72 |h as rep|orter cr|
|00002bc0| 65 61 74 69 6f 6e 20 61 | 6e 64 20 61 72 74 69 63 |eation a|nd artic|
|00002bd0| 6c 65 20 72 65 74 72 69 | 65 76 61 6c 20 6f 6e 6c |le retri|eval onl|
|00002be0| 79 20 69 66 20 69 74 20 | 69 73 20 72 75 6e 6e 69 |y if it |is runni|
|00002bf0| 6e 67 2e 20 28 49 66 20 | 69 74 20 69 73 20 6e 6f |ng. (If |it is no|
|00002c00| 74 20 72 75 6e 6e 69 6e | 67 2c 20 74 68 65 20 75 |t runnin|g, the u|
|00002c10| 73 65 72 20 63 61 6e 20 | 6f 6e 6c 79 20 6f 70 65 |ser can |only ope|
|00002c20| 6e 20 61 6e 64 20 76 69 | 65 77 20 65 78 69 73 74 |n and vi|ew exist|
|00002c30| 69 6e 67 20 61 72 74 69 | 63 6c 65 20 61 6e 64 20 |ing arti|cle and |
|00002c40| 75 70 64 61 74 65 20 66 | 69 6c 65 73 20 6f 6e 20 |update f|iles on |
|00002c50| 74 68 65 20 6d 6f 75 6e | 74 65 64 20 76 6f 6c 75 |the moun|ted volu|
|00002c60| 6d 65 73 2e 29 20 54 68 | 65 20 41 70 70 6c 65 53 |mes.) Th|e AppleS|
|00002c70| 65 61 72 63 68 20 43 6f | 6d 6d 75 6e 69 63 61 74 |earch Co|mmunicat|
|00002c80| 69 6f 6e 20 45 78 74 65 | 6e 73 69 6f 6e 20 69 73 |ion Exte|nsion is|
|00002c90| 20 73 74 6f 72 65 64 20 | 69 6e 20 74 68 65 20 75 | stored |in the u|
|00002ca0| 73 65 72 d5 73 20 45 78 | 74 65 6e 73 69 6f 6e 73 |ser.s Ex|tensions|
|00002cb0| 20 66 6f 6c 64 65 72 2e | 20 0d 54 68 65 20 41 70 | folder.| .The Ap|
|00002cc0| 70 6c 65 53 65 61 72 63 | 68 20 41 75 74 68 65 6e |pleSearc|h Authen|
|00002cd0| 74 69 63 61 74 69 6f 6e | 20 45 78 74 65 6e 73 69 |tication| Extensi|
|00002ce0| 6f 6e 20 64 69 73 70 6c | 61 79 73 20 61 20 63 6f |on displ|ays a co|
|00002cf0| 6e 6e 65 63 74 69 6f 6e | 20 64 69 61 6c 6f 67 20 |nnection| dialog |
|00002d00| 62 6f 78 20 74 68 61 74 | 20 61 6c 6c 6f 77 73 20 |box that| allows |
|00002d10| 74 68 65 20 75 73 65 72 | 20 74 6f 20 6f 70 65 6e |the user| to open|
|00002d20| 20 61 20 73 65 73 73 69 | 6f 6e 20 77 69 74 68 20 | a sessi|on with |
|00002d30| 61 6e 20 41 70 70 6c 65 | 53 65 61 72 63 68 20 73 |an Apple|Search s|
|00002d40| 65 72 76 65 72 2e 20 4f | 6e 63 65 20 74 68 65 20 |erver. O|nce the |
|00002d50| 75 73 65 72 20 63 6f 6d | 70 6c 65 74 65 73 20 74 |user com|pletes t|
|00002d60| 68 65 20 6c 6f 67 2d 6f | 6e 20 70 72 6f 63 65 73 |he log-o|n proces|
|00002d70| 73 2c 20 74 68 65 20 41 | 70 70 6c 65 53 65 61 72 |s, the A|ppleSear|
|00002d80| 63 68 20 41 75 74 68 65 | 6e 74 69 63 61 74 69 6f |ch Authe|nticatio|
|00002d90| 6e 20 45 78 74 65 6e 73 | 69 6f 6e 20 73 65 6e 64 |n Extens|ion send|
|00002da0| 73 20 73 65 73 73 69 6f | 6e 20 69 6e 66 6f 72 6d |s sessio|n inform|
|00002db0| 61 74 69 6f 6e 20 74 6f | 20 74 68 65 20 41 70 70 |ation to| the App|
|00002dc0| 6c 65 53 65 61 72 63 68 | 20 43 6f 6d 6d 75 6e 69 |leSearch| Communi|
|00002dd0| 63 61 74 69 6f 6e 20 45 | 78 74 65 6e 73 69 6f 6e |cation E|xtension|
|00002de0| 20 61 6e 64 20 74 68 65 | 6e 20 71 75 69 74 73 2e | and the|n quits.|
|00002df0| 20 54 68 65 20 41 70 70 | 6c 65 53 65 61 72 63 68 | The App|leSearch|
|00002e00| 20 41 75 74 68 65 6e 74 | 69 63 61 74 69 6f 6e 20 | Authent|ication |
|00002e10| 45 78 74 65 6e 73 69 6f | 6e 20 61 70 70 6c 69 63 |Extensio|n applic|
|00002e20| 61 74 69 6f 6e 20 69 73 | 20 73 74 6f 72 65 64 20 |ation is| stored |
|00002e30| 69 6e 20 74 68 65 20 75 | 73 65 72 d5 73 20 45 78 |in the u|ser.s Ex|
|00002e40| 74 65 6e 73 69 6f 6e 73 | 20 66 6f 6c 64 65 72 2e |tensions| folder.|
|00002e50| 20 0d 41 6c 6c 20 74 68 | 72 65 65 20 63 6f 6d 70 | .All th|ree comp|
|00002e60| 6f 6e 65 6e 74 73 20 63 | 6f 6d 6d 75 6e 69 63 61 |onents c|ommunica|
|00002e70| 74 65 20 77 69 74 68 20 | 65 61 63 68 20 6f 74 68 |te with |each oth|
|00002e80| 65 72 20 62 79 20 77 61 | 79 20 6f 66 20 41 70 70 |er by wa|y of App|
|00002e90| 6c 65 20 65 76 65 6e 74 | 73 2e 20 54 68 65 20 41 |le event|s. The A|
|00002ea0| 70 70 6c 65 53 65 61 72 | 63 68 20 43 6f 6d 6d 75 |ppleSear|ch Commu|
|00002eb0| 6e 69 63 61 74 69 6f 6e | 20 45 78 74 65 6e 73 69 |nication| Extensi|
|00002ec0| 6f 6e 20 61 6e 64 20 74 | 68 65 20 41 70 70 6c 65 |on and t|he Apple|
|00002ed0| 53 65 61 72 63 68 20 53 | 65 72 76 65 72 20 63 6f |Search S|erver co|
|00002ee0| 6d 6d 75 6e 69 63 61 74 | 65 20 62 79 75 73 69 6e |mmunicat|e byusin|
|00002ef0| 67 20 74 68 65 20 41 70 | 70 6c 65 53 65 61 72 63 |g the Ap|pleSearc|
|00002f00| 68 20 43 6c 69 65 6e 74 | 2f 53 65 72 76 65 72 20 |h Client|/Server |
|00002f10| 70 72 6f 74 6f 63 6f 6c | 20 28 61 6e 20 41 70 70 |protocol| (an App|
|00002f20| 6c 65 20 70 72 6f 70 72 | 69 65 74 61 72 79 20 70 |le propr|ietary p|
|00002f30| 72 6f 74 6f 63 6f 6c 29 | 2e 20 46 6f 72 20 69 6e |rotocol)|. For in|
|00002f40| 73 74 61 6e 63 65 2c 20 | 77 68 65 6e 20 61 20 75 |stance, |when a u|
|00002f50| 73 65 72 20 64 6f 75 62 | 6c 65 2d 63 6c 69 63 6b |ser doub|le-click|
|00002f60| 73 20 61 20 72 65 70 6f | 72 74 65 72 20 69 6e 20 |s a repo|rter in |
|00002f70| 74 68 65 20 41 70 70 6c | 65 53 65 61 72 63 68 20 |the Appl|eSearch |
|00002f80| 77 69 6e 64 6f 77 2c 20 | 74 68 65 20 66 6f 6c 6c |window, |the foll|
|00002f90| 6f 77 69 6e 67 20 6f 63 | 63 75 72 73 3a 20 0d 6d |owing oc|curs: .m|
|00002fa0| 09 54 68 65 20 41 70 70 | 6c 65 53 65 61 72 63 68 |.The App|leSearch|
|00002fb0| 20 43 6c 69 65 6e 74 20 | 73 65 6e 64 73 20 61 6e | Client |sends an|
|00002fc0| 20 41 70 70 6c 65 20 65 | 76 65 6e 74 20 74 6f 20 | Apple e|vent to |
|00002fd0| 74 68 65 20 41 70 70 6c | 65 53 65 61 72 63 68 20 |the Appl|eSearch |
|00002fe0| 43 6f 6d 6d 75 6e 69 63 | 61 74 69 6f 6e 20 45 78 |Communic|ation Ex|
|00002ff0| 74 65 6e 73 69 6f 6e 2c | 20 61 73 6b 69 6e 67 20 |tension,| asking |
|00003000| 66 6f 72 20 69 6e 66 6f | 72 6d 61 74 69 6f 6e 20 |for info|rmation |
|00003010| 6f 6e 20 74 68 61 74 20 | 72 65 70 6f 72 74 65 72 |on that |reporter|
|00003020| 2e 20 0d 6d 09 54 68 65 | 20 41 70 70 6c 65 53 65 |. .m.The| AppleSe|
|00003030| 61 72 63 68 20 43 6f 6d | 6d 75 6e 69 63 61 74 69 |arch Com|municati|
|00003040| 6f 6e 20 45 78 74 65 6e | 73 69 6f 6e 20 72 65 74 |on Exten|sion ret|
|00003050| 72 69 65 76 65 73 20 74 | 68 65 20 69 6e 66 6f 72 |rieves t|he infor|
|00003060| 6d 61 74 69 6f 6e 20 66 | 72 6f 6d 20 74 68 65 20 |mation f|rom the |
|00003070| 73 65 72 76 65 72 20 62 | 79 20 75 73 69 6e 67 20 |server b|y using |
|00003080| 74 68 65 20 41 70 70 6c | 65 53 65 61 72 63 68 20 |the Appl|eSearch |
|00003090| 43 6c 69 65 6e 74 2f 53 | 65 72 76 65 72 20 70 72 |Client/S|erver pr|
|000030a0| 6f 74 6f 63 6f 6c 2e 20 | 0d 6d 09 54 68 65 20 41 |otocol. |.m.The A|
|000030b0| 70 70 6c 65 53 65 61 72 | 63 68 20 43 6f 6d 6d 75 |ppleSear|ch Commu|
|000030c0| 6e 69 63 61 74 69 6f 6e | 20 45 78 74 65 6e 73 69 |nication| Extensi|
|000030d0| 6f 6e 20 70 61 73 73 65 | 73 20 74 68 65 20 69 6e |on passe|s the in|
|000030e0| 66 6f 72 6d 61 74 69 6f | 6e 20 74 6f 20 74 68 65 |formatio|n to the|
|000030f0| 20 41 70 70 6c 65 53 65 | 61 72 63 68 20 43 6c 69 | AppleSe|arch Cli|
|00003100| 65 6e 74 20 69 6e 20 61 | 20 72 65 70 6c 79 20 65 |ent in a| reply e|
|00003110| 76 65 6e 74 20 74 6f 20 | 74 68 65 20 6f 72 69 67 |vent to |the orig|
|00003120| 69 6e 61 6c 20 72 65 71 | 75 65 73 74 2e 0d 6d 09 |inal req|uest..m.|
|00003130| 54 68 65 20 41 70 70 6c | 65 53 65 61 72 63 68 20 |The Appl|eSearch |
|00003140| 43 6c 69 65 6e 74 20 64 | 69 73 70 6c 61 79 73 20 |Client d|isplays |
|00003150| 74 68 65 20 72 65 70 6f | 72 74 65 72 20 77 69 6e |the repo|rter win|
|00003160| 64 6f 77 2c 20 77 68 69 | 63 68 20 63 6f 6e 74 61 |dow, whi|ch conta|
|00003170| 69 6e 73 20 69 6e 66 6f | 72 6d 61 74 69 6f 6e 20 |ins info|rmation |
|00003180| 61 62 6f 75 74 20 74 68 | 61 74 20 72 65 70 6f 72 |about th|at repor|
|00003190| 74 65 72 2e 20 0d 57 72 | 69 74 69 6e 67 20 79 6f |ter. .Wr|iting yo|
|000031a0| 75 72 20 6f 77 6e 20 63 | 6c 69 65 6e 74 20 61 70 |ur own c|lient ap|
|000031b0| 70 6c 69 63 61 74 69 6f | 6e 0d 59 6f 75 20 63 61 |plicatio|n.You ca|
|000031c0| 6e 20 77 72 69 74 65 20 | 79 6f 75 72 20 6f 77 6e |n write |your own|
|000031d0| 20 63 6c 69 65 6e 74 20 | 61 70 70 6c 69 63 61 74 | client |applicat|
|000031e0| 69 6f 6e 20 74 6f 20 61 | 63 63 65 73 73 20 41 70 |ion to a|ccess Ap|
|000031f0| 70 6c 65 53 65 61 72 63 | 68 20 73 65 72 76 65 72 |pleSearc|h server|
|00003200| 73 20 69 6e 20 65 69 74 | 68 65 72 20 6f 66 20 74 |s in eit|her of t|
|00003210| 77 6f 20 77 61 79 73 3a | 20 0d 6d 09 59 6f 75 20 |wo ways:| .m.You |
|00003220| 63 61 6e 20 77 72 69 74 | 65 20 61 6e 20 61 70 70 |can writ|e an app|
|00003230| 6c 69 63 61 74 69 6f 6e | 20 74 68 61 74 20 72 65 |lication| that re|
|00003240| 70 6c 61 63 65 73 20 74 | 68 65 20 41 70 70 6c 65 |places t|he Apple|
|00003250| 53 65 61 72 63 68 20 55 | 73 65 72 20 49 6e 74 65 |Search U|ser Inte|
|00003260| 72 66 61 63 65 20 61 70 | 70 6c 69 63 61 74 69 6f |rface ap|plicatio|
|00003270| 6e 20 70 72 6f 76 69 64 | 65 64 20 62 79 20 41 70 |n provid|ed by Ap|
|00003280| 70 6c 65 2e 20 49 6e 20 | 74 68 69 73 20 63 61 73 |ple. In |this cas|
|00003290| 65 2c 20 79 6f 75 72 20 | 61 70 70 6c 69 63 61 74 |e, your |applicat|
|000032a0| 69 6f 6e 20 6d 75 73 74 | 20 75 73 65 20 41 70 70 |ion must| use App|
|000032b0| 6c 65 20 65 76 65 6e 74 | 73 20 74 6f 20 63 6f 6d |le event|s to com|
|000032c0| 6d 75 6e 69 63 61 74 65 | 20 77 69 74 68 20 74 68 |municate| with th|
|000032d0| 65 20 41 70 70 6c 65 53 | 65 61 72 63 68 20 43 6f |e AppleS|earch Co|
|000032e0| 6d 6d 75 6e 69 63 61 74 | 69 6f 6e 20 45 78 74 65 |mmunicat|ion Exte|
|000032f0| 6e 73 69 6f 6e 2c 20 77 | 68 69 63 68 20 69 6e 20 |nsion, w|hich in |
|00003300| 74 75 72 6e 20 63 6f 6d | 6d 75 6e 69 63 61 74 65 |turn com|municate|
|00003310| 73 20 77 69 74 68 20 74 | 68 65 20 41 70 70 6c 65 |s with t|he Apple|
|00003320| 53 65 61 72 63 68 20 73 | 65 72 76 65 72 2e 20 0d |Search s|erver. .|
|00003330| 6d 09 59 6f 75 20 63 61 | 6e 20 6c 69 6e 6b 20 79 |m.You ca|n link y|
|00003340| 6f 75 72 20 61 70 70 6c | 69 63 61 74 69 6f 6e 20 |our appl|ication |
|00003350| 64 69 72 65 63 74 6c 79 | 20 74 6f 20 74 68 65 20 |directly| to the |
|00003360| 41 70 70 6c 65 53 65 61 | 72 63 68 20 43 6c 69 65 |AppleSea|rch Clie|
|00003370| 6e 74 20 4c 69 62 72 61 | 72 79 2c 20 61 20 70 61 |nt Libra|ry, a pa|
|00003380| 72 74 20 6f 66 20 74 68 | 65 20 41 70 70 6c 65 53 |rt of th|e AppleS|
|00003390| 65 61 72 63 68 20 43 6f | 6d 6d 75 6e 69 63 61 74 |earch Co|mmunicat|
|000033a0| 69 6f 6e 20 45 78 74 65 | 6e 73 69 6f 6e 2e 20 59 |ion Exte|nsion. Y|
|000033b0| 6f 75 20 77 69 6c 6c 20 | 6e 65 65 64 20 74 6f 20 |ou will |need to |
|000033c0| 6d 61 6b 65 20 43 20 66 | 75 6e 63 74 69 6f 6e 20 |make C f|unction |
|000033d0| 63 61 6c 6c 73 20 74 6f | 20 74 68 65 20 41 70 70 |calls to| the App|
|000033e0| 6c 65 53 65 61 72 63 68 | 20 43 6c 69 65 6e 74 20 |leSearch| Client |
|000033f0| 4c 69 62 72 61 72 79 20 | 69 6e 20 6f 72 64 65 72 |Library |in order|
|00003400| 20 74 6f 20 61 63 63 65 | 73 73 20 74 68 65 20 73 | to acce|ss the s|
|00003410| 65 72 76 65 72 2e 0d 54 | 68 65 20 61 64 76 61 6e |erver..T|he advan|
|00003420| 74 61 67 65 20 6f 66 20 | 75 73 69 6e 67 20 41 70 |tage of |using Ap|
|00003430| 70 6c 65 20 65 76 65 6e | 74 73 20 69 73 20 74 68 |ple even|ts is th|
|00003440| 61 74 20 79 6f 75 20 77 | 6f 6e d5 74 20 68 61 76 |at you w|on.t hav|
|00003450| 65 20 74 6f 20 63 68 61 | 6e 67 65 20 79 6f 75 72 |e to cha|nge your|
|00003460| 20 75 73 65 72 20 69 6e | 74 65 72 66 61 63 65 20 | user in|terface |
|00003470| 61 70 70 6c 69 63 61 74 | 69 6f 6e 20 69 66 20 41 |applicat|ion if A|
|00003480| 70 70 6c 65 20 72 65 70 | 6c 61 63 65 73 20 74 68 |pple rep|laces th|
|00003490| 65 20 74 72 61 6e 73 70 | 6f 72 74 2d 6c 61 79 65 |e transp|ort-laye|
|000034a0| 72 2d 6c 65 76 65 6c 20 | 70 72 6f 74 6f 63 6f 6c |r-level |protocol|
|000034b0| 20 69 6e 20 66 75 74 75 | 72 65 20 72 65 6c 65 61 | in futu|re relea|
|000034c0| 73 65 73 20 6f 66 20 74 | 68 65 20 70 72 6f 64 75 |ses of t|he produ|
|000034d0| 63 74 2e 20 41 6c 73 6f | 2c 20 69 66 20 79 6f 75 |ct. Also|, if you|
|000034e0| 72 20 61 70 70 6c 69 63 | 61 74 69 6f 6e 20 73 75 |r applic|ation su|
|000034f0| 70 70 6f 72 74 73 20 75 | 70 64 61 74 65 20 64 65 |pports u|pdate de|
|00003500| 6c 69 76 65 72 79 20 75 | 73 69 6e 67 20 74 68 65 |livery u|sing the|
|00003510| 20 41 70 70 6c 65 53 65 | 61 72 63 68 20 43 6f 6d | AppleSe|arch Com|
|00003520| 6d 75 6e 69 63 61 74 69 | 6f 6e 20 45 78 74 65 6e |municati|on Exten|
|00003530| 73 69 6f 6e 2c 20 75 73 | 65 72 73 20 63 61 6e 20 |sion, us|ers can |
|00003540| 72 65 63 65 69 76 65 20 | 75 70 64 61 74 65 73 20 |receive |updates |
|00003550| 77 69 74 68 6f 75 74 20 | 68 61 76 69 6e 67 20 74 |without |having t|
|00003560| 68 65 69 72 20 75 73 65 | 72 20 69 6e 74 65 72 66 |heir use|r interf|
|00003570| 61 63 65 20 61 70 70 6c | 69 63 61 74 69 6f 6e 20 |ace appl|ication |
|00003580| 72 75 6e 6e 69 6e 67 2e | 0d 54 68 65 20 61 64 76 |running.|.The adv|
|00003590| 61 6e 74 61 67 65 20 6f | 66 20 75 73 69 6e 67 20 |antage o|f using |
|000035a0| 74 68 65 20 43 20 41 50 | 49 20 69 73 20 79 6f 75 |the C AP|I is you|
|000035b0| 20 68 61 76 65 20 6d 6f | 72 65 20 66 6c 65 78 69 | have mo|re flexi|
|000035c0| 62 69 6c 69 74 79 20 74 | 68 61 6e 20 79 6f 75 20 |bility t|han you |
|000035d0| 64 6f 20 77 69 74 68 20 | 41 70 70 6c 65 20 65 76 |do with |Apple ev|
|000035e0| 65 6e 74 73 2e 20 46 6f | 72 20 69 6e 73 74 61 6e |ents. Fo|r instan|
|000035f0| 63 65 2c 20 79 6f 75 20 | 63 61 6e 20 6d 61 6b 65 |ce, you |can make|
|00003600| 20 61 20 43 20 66 75 6e | 63 74 69 6f 6e 20 63 61 | a C fun|ction ca|
|00003610| 6c 6c 20 74 68 61 74 20 | 61 6c 6c 6f 77 73 20 61 |ll that |allows a|
|00003620| 20 75 73 65 72 20 74 6f | 20 63 6f 6e 6e 65 63 74 | user to| connect|
|00003630| 20 74 6f 20 74 68 65 20 | 73 65 72 76 65 72 20 77 | to the |server w|
|00003640| 69 74 68 6f 75 74 20 75 | 73 69 6e 67 20 74 68 65 |ithout u|sing the|
|00003650| 20 41 70 70 6c 65 53 65 | 61 72 63 68 20 41 75 74 | AppleSe|arch Aut|
|00003660| 68 65 6e 74 69 63 61 74 | 69 6f 6e 20 45 78 74 65 |henticat|ion Exte|
|00003670| 6e 73 69 6f 6e 2e 0d 54 | 68 65 20 66 6f 6c 6c 6f |nsion..T|he follo|
|00003680| 77 69 6e 67 20 64 69 61 | 67 72 61 6d 20 73 68 6f |wing dia|gram sho|
|00003690| 77 73 20 68 6f 77 20 74 | 68 65 20 76 61 72 69 6f |ws how t|he vario|
|000036a0| 75 73 20 63 6f 6d 70 6f | 6e 65 6e 74 73 20 69 6e |us compo|nents in|
|000036b0| 74 65 72 61 63 74 2e 0d | 20 0d 43 6c 69 65 6e 74 |teract..| .Client|
|000036c0| 2f 73 65 72 76 65 72 20 | 63 6f 6e 6e 65 63 74 69 |/server |connecti|
|000036d0| 6f 6e 0d 54 68 65 20 41 | 70 70 6c 65 53 65 61 72 |on.The A|ppleSear|
|000036e0| 63 68 20 43 6c 69 65 6e | 74 2f 53 65 72 76 65 72 |ch Clien|t/Server|
|000036f0| 20 70 72 6f 74 6f 63 6f | 6c 20 72 65 73 69 64 65 | protoco|l reside|
|00003700| 73 20 6f 6e 20 74 6f 70 | 20 6f 66 20 74 68 65 20 |s on top| of the |
|00003710| 50 72 6f 67 72 61 6d 2d | 74 6f 2d 50 72 6f 67 72 |Program-|to-Progr|
|00003720| 61 6d 20 43 6f 6d 6d 75 | 6e 69 63 61 74 69 6f 6e |am Commu|nication|
|00003730| 73 20 28 50 50 43 29 20 | 70 72 6f 74 6f 63 6f 6c |s (PPC) |protocol|
|00003740| 2e 20 54 68 65 20 41 70 | 70 6c 65 53 65 61 72 63 |. The Ap|pleSearc|
|00003750| 68 20 43 6c 69 65 6e 74 | 2f 53 65 72 76 65 72 20 |h Client|/Server |
|00003760| 70 72 6f 74 6f 63 6f 6c | 20 75 73 65 73 20 50 50 |protocol| uses PP|
|00003770| 43 20 74 6f 20 73 65 6e | 64 20 61 6e 64 20 72 65 |C to sen|d and re|
|00003780| 63 65 69 76 65 20 68 69 | 67 68 2d 6c 65 76 65 6c |ceive hi|gh-level|
|00003790| 20 6d 65 73 73 61 67 65 | 20 62 6c 6f 63 6b 73 20 | message| blocks |
|000037a0| 62 65 74 77 65 65 6e 20 | 74 68 65 20 41 70 70 6c |between |the Appl|
|000037b0| 65 53 65 61 72 63 68 20 | 43 6f 6d 6d 75 6e 69 63 |eSearch |Communic|
|000037c0| 61 74 69 6f 6e 20 45 78 | 74 65 6e 73 69 6f 6e 20 |ation Ex|tension |
|000037d0| 61 6e 64 20 74 68 65 20 | 41 70 70 6c 65 53 65 61 |and the |AppleSea|
|000037e0| 72 63 68 20 53 65 72 76 | 65 72 2e 20 0d 4e 6f 74 |rch Serv|er. .Not|
|000037f0| 65 3a 20 20 49 6e 20 66 | 75 74 75 72 65 20 76 65 |e: In f|uture ve|
|00003800| 72 73 69 6f 6e 73 20 6f | 66 20 41 70 70 6c 65 53 |rsions o|f AppleS|
|00003810| 65 61 72 63 68 2c 20 61 | 6e 6f 74 68 65 72 20 74 |earch, a|nother t|
|00003820| 72 61 6e 73 70 6f 72 74 | 2d 6c 61 79 65 72 2d 6c |ransport|-layer-l|
|00003830| 65 76 65 6c 20 70 72 6f | 74 6f 63 6f 6c 20 62 65 |evel pro|tocol be|
|00003840| 73 69 64 65 73 20 50 50 | 43 20 6d 61 79 20 62 65 |sides PP|C may be|
|00003850| 20 75 73 65 64 2e 0d 0d | 54 68 65 20 63 6c 69 65 | used...|The clie|
|00003860| 6e 74 2f 73 65 72 76 65 | 72 20 63 6f 6e 6e 65 63 |nt/serve|r connec|
|00003870| 74 69 6f 6e 20 69 73 20 | 65 73 74 61 62 6c 69 73 |tion is |establis|
|00003880| 68 65 64 20 77 68 65 6e | 20 74 68 65 20 63 6c 69 |hed when| the cli|
|00003890| 65 6e 74 d5 73 20 6c 6f | 67 2d 6f 6e 20 72 65 71 |ent.s lo|g-on req|
|000038a0| 75 65 73 74 20 69 73 20 | 73 75 63 63 65 73 73 66 |uest is |successf|
|000038b0| 75 6c 6c 79 20 70 72 6f | 63 65 73 73 65 64 20 62 |ully pro|cessed b|
|000038c0| 79 20 74 68 65 20 73 65 | 72 76 65 72 2e 20 49 6e |y the se|rver. In|
|000038d0| 20 41 70 70 6c 65 53 65 | 61 72 63 68 2c 20 61 20 | AppleSe|arch, a |
|000038e0| 63 6c 69 65 6e 74 20 63 | 61 6e 20 63 6f 6e 6e 65 |client c|an conne|
|000038f0| 63 74 20 74 6f 20 6f 6e | 6c 79 20 6f 6e 65 20 73 |ct to on|ly one s|
|00003900| 65 72 76 65 72 20 61 74 | 20 61 20 74 69 6d 65 2e |erver at| a time.|
|00003910| 20 4f 6e 63 65 20 74 68 | 65 20 63 6f 6e 6e 65 63 | Once th|e connec|
|00003920| 74 69 6f 6e 20 69 73 20 | 6d 61 64 65 2c 20 74 68 |tion is |made, th|
|00003930| 65 20 75 73 65 72 20 63 | 61 6e 20 70 65 72 66 6f |e user c|an perfo|
|00003940| 72 6d 20 61 6c 6c 20 41 | 70 70 6c 65 53 65 61 72 |rm all A|ppleSear|
|00003950| 63 68 20 66 75 6e 63 74 | 69 6f 6e 73 d1 69 6e 63 |ch funct|ions.inc|
|00003960| 6c 75 64 69 6e 67 20 73 | 65 61 72 63 68 69 6e 67 |luding s|earching|
|00003970| 20 69 6e 66 6f 72 6d 61 | 74 69 6f 6e 20 73 6f 75 | informa|tion sou|
|00003980| 72 63 65 73 2c 20 72 65 | 74 72 69 65 76 69 6e 67 |rces, re|trieving|
|00003990| 20 61 72 74 69 63 6c 65 | 73 2c 20 61 6e 64 20 61 | article|s, and a|
|000039a0| 64 64 69 6e 67 20 72 65 | 70 6f 72 74 65 72 73 20 |dding re|porters |
|000039b0| 74 6f 20 74 68 65 20 73 | 65 72 76 65 72 d1 75 6e |to the s|erver.un|
|000039c0| 74 69 6c 20 74 68 65 20 | 63 6f 6e 6e 65 63 74 69 |til the |connecti|
|000039d0| 6f 6e 20 69 73 20 74 65 | 72 6d 69 6e 61 74 65 64 |on is te|rminated|
|000039e0| 2e 20 49 66 20 74 68 65 | 20 75 73 65 72 20 69 73 |. If the| user is|
|000039f0| 20 63 6f 6e 6e 65 63 74 | 65 64 20 61 73 20 61 20 | connect|ed as a |
|00003a00| 67 75 65 73 74 2c 20 74 | 68 65 20 63 6c 69 65 6e |guest, t|he clien|
|00003a10| 74 20 63 61 6e 6e 6f 74 | 20 6d 61 6b 65 20 72 65 |t cannot| make re|
|00003a20| 70 6f 72 74 65 72 2d 20 | 6f 72 20 6f 62 6a 65 63 |porter- |or objec|
|00003a30| 74 2d 64 61 74 61 62 61 | 73 65 2d 72 65 6c 61 74 |t-databa|se-relat|
|00003a40| 65 64 20 72 65 71 75 65 | 73 74 73 20 74 6f 20 74 |ed reque|sts to t|
|00003a50| 68 65 20 73 65 72 76 65 | 72 2e 20 28 54 68 65 20 |he serve|r. (The |
|00003a60| 73 65 72 76 65 72 20 6f | 62 6a 65 63 74 20 64 61 |server o|bject da|
|00003a70| 74 61 62 61 73 65 20 69 | 73 20 64 65 73 63 72 69 |tabase i|s descri|
|00003a80| 62 65 64 20 69 6e 20 74 | 68 65 20 73 65 63 74 69 |bed in t|he secti|
|00003a90| 6f 6e 20 d2 53 65 72 76 | 65 72 20 4f 62 6a 65 63 |on .Serv|er Objec|
|00003aa0| 74 20 44 61 74 61 62 61 | 73 65 d3 20 6c 61 74 65 |t Databa|se. late|
|00003ab0| 72 20 69 6e 20 74 68 69 | 73 20 63 68 61 70 74 65 |r in thi|s chapte|
|00003ac0| 72 2e 29 20 0d 54 68 65 | 20 63 6c 69 65 6e 74 2f |r.) .The| client/|
|00003ad0| 73 65 72 76 65 72 20 63 | 6f 6e 6e 65 63 74 69 6f |server c|onnectio|
|00003ae0| 6e 20 69 73 20 74 65 72 | 6d 69 6e 61 74 65 64 20 |n is ter|minated |
|00003af0| 69 6e 20 6f 6e 65 20 6f | 66 20 74 68 72 65 65 20 |in one o|f three |
|00003b00| 77 61 79 73 3a 0d 6d 09 | 57 68 65 6e 20 61 20 63 |ways:.m.|When a c|
|00003b10| 6c 69 65 6e 74 20 6c 6f | 67 73 20 6f 66 66 2c 20 |lient lo|gs off, |
|00003b20| 61 20 4c 6f 67 6f 66 66 | 20 63 61 6c 6c 20 69 73 |a Logoff| call is|
|00003b30| 20 69 73 73 75 65 64 3b | 20 74 68 65 20 41 70 70 | issued;| the App|
|00003b40| 6c 65 53 65 61 72 63 68 | 20 63 6c 69 65 6e 74 20 |leSearch| client |
|00003b50| 69 6e 64 69 63 61 74 65 | 73 20 61 20 64 69 73 63 |indicate|s a disc|
|00003b60| 6f 6e 6e 65 63 74 20 74 | 6f 20 74 68 65 20 41 70 |onnect t|o the Ap|
|00003b70| 70 6c 65 53 65 61 72 63 | 68 20 43 6f 6d 6d 75 6e |pleSearc|h Commun|
|00003b80| 69 63 61 74 69 6f 6e 73 | 20 45 78 74 65 6e 73 69 |ications| Extensi|
|00003b90| 6f 6e 2c 20 77 68 69 63 | 68 20 6d 61 6b 65 73 20 |on, whic|h makes |
|00003ba0| 74 68 65 20 4c 6f 67 6f | 66 66 20 63 61 6c 6c 20 |the Logo|ff call |
|00003bb0| 74 6f 20 74 68 65 20 41 | 70 70 6c 65 53 65 61 72 |to the A|ppleSear|
|00003bc0| 63 68 20 73 65 72 76 65 | 72 2e 0d 6d 09 57 68 65 |ch serve|r..m.Whe|
|00003bd0| 6e 20 61 20 63 6c 69 65 | 6e 74 20 65 6e 63 6f 75 |n a clie|nt encou|
|00003be0| 6e 74 65 72 73 20 61 20 | 66 61 74 61 6c 20 65 72 |nters a |fatal er|
|00003bf0| 72 6f 72 2c 20 73 75 63 | 68 20 61 73 20 61 20 50 |ror, suc|h as a P|
|00003c00| 50 43 20 63 6f 6d 6d 75 | 6e 69 63 61 74 69 6f 6e |PC commu|nication|
|00003c10| 20 65 72 72 6f 72 2c 20 | 69 74 20 64 69 73 63 6f | error, |it disco|
|00003c20| 6e 6e 65 63 74 73 20 69 | 74 73 65 6c 66 2e 20 0d |nnects i|tself. .|
|00003c30| 6d 09 57 68 65 6e 20 74 | 68 65 20 63 6f 6d 6d 75 |m.When t|he commu|
|00003c40| 6e 69 63 61 74 69 6f 6e | 20 6c 61 79 65 72 20 6e |nication| layer n|
|00003c50| 6f 74 69 66 69 65 73 20 | 74 68 65 20 63 6c 69 65 |otifies |the clie|
|00003c60| 6e 74 20 61 6e 64 2f 6f | 72 20 73 65 72 76 65 72 |nt and/o|r server|
|00003c70| 20 74 68 61 74 20 74 68 | 65 20 63 6f 6e 6e 65 63 | that th|e connec|
|00003c80| 74 69 6f 6e 20 69 73 20 | 6e 6f 20 6c 6f 6e 67 65 |tion is |no longe|
|00003c90| 72 20 74 68 65 72 65 2c | 20 74 68 65 20 73 65 72 |r there,| the ser|
|00003ca0| 76 65 72 20 64 69 73 63 | 6f 6e 6e 65 63 74 73 20 |ver disc|onnects |
|00003cb0| 69 74 73 65 6c 66 2e 20 | 0d 49 6e 66 6f 72 6d 61 |itself. |.Informa|
|00003cc0| 74 69 6f 6e 20 73 6f 75 | 72 63 65 73 0d 54 68 65 |tion sou|rces.The|
|00003cd0| 20 6c 6f 63 61 6c 20 69 | 6e 66 6f 72 6d 61 74 69 | local i|nformati|
|00003ce0| 6f 6e 20 73 6f 75 72 63 | 65 73 20 74 68 61 74 20 |on sourc|es that |
|00003cf0| 75 73 65 72 73 20 63 61 | 6e 20 73 65 61 72 63 68 |users ca|n search|
|00003d00| 20 61 72 65 20 73 68 61 | 72 65 64 20 76 6f 6c 75 | are sha|red volu|
|00003d10| 6d 65 73 20 6f 72 20 66 | 6f 6c 64 65 72 73 2c 20 |mes or f|olders, |
|00003d20| 63 6f 6e 74 61 69 6e 69 | 6e 67 20 64 6f 63 75 6d |containi|ng docum|
|00003d30| 65 6e 74 73 20 69 6e 20 | 76 61 72 69 6f 75 73 20 |ents in |various |
|00003d40| 66 6f 72 6d 61 74 73 2c | 20 74 68 61 74 20 72 65 |formats,| that re|
|00003d50| 73 69 64 65 20 6f 6e 20 | 61 6e 20 41 70 70 6c 65 |side on |an Apple|
|00003d60| 53 65 61 72 63 68 20 73 | 65 72 76 65 72 2e 20 55 |Search s|erver. U|
|00003d70| 73 65 72 73 20 6d 75 73 | 74 20 68 61 76 65 20 61 |sers mus|t have a|
|00003d80| 70 70 72 6f 70 72 69 61 | 74 65 20 61 63 63 65 73 |ppropria|te acces|
|00003d90| 73 20 70 72 69 76 69 6c | 65 67 65 73 20 74 6f 20 |s privil|eges to |
|00003da0| 66 6f 6c 64 65 72 73 20 | 6f 6e 20 74 68 65 20 73 |folders |on the s|
|00003db0| 65 72 76 65 72 20 62 65 | 66 6f 72 65 20 74 68 65 |erver be|fore the|
|00003dc0| 79 20 63 61 6e 20 76 69 | 65 77 20 6f 72 20 73 65 |y can vi|ew or se|
|00003dd0| 61 72 63 68 20 69 6e 66 | 6f 72 6d 61 74 69 6f 6e |arch inf|ormation|
|00003de0| 20 73 6f 75 72 63 65 73 | 20 6f 6e 20 74 68 61 74 | sources| on that|
|00003df0| 20 73 65 72 76 65 72 3b | 20 61 63 63 65 73 73 20 | server;| access |
|00003e00| 70 72 69 76 69 6c 65 67 | 65 73 20 61 72 65 20 70 |privileg|es are p|
|00003e10| 72 6f 76 69 64 65 64 20 | 62 79 20 41 70 70 6c 65 |rovided |by Apple|
|00003e20| 53 68 61 72 65 20 6f 72 | 20 62 79 20 4d 61 63 69 |Share or| by Maci|
|00003e30| 6e 74 6f 73 68 20 66 69 | 6c 65 20 73 68 61 72 69 |ntosh fi|le shari|
|00003e40| 6e 67 20 69 6e 20 53 79 | 73 74 65 6d 20 37 2e 20 |ng in Sy|stem 7. |
|00003e50| 0d 41 70 70 6c 65 53 65 | 61 72 63 68 20 61 6c 73 |.AppleSe|arch als|
|00003e60| 6f 20 73 75 70 70 6f 72 | 74 73 20 57 41 49 53 20 |o suppor|ts WAIS |
|00003e70| 28 77 69 64 65 20 61 72 | 65 61 20 69 6e 66 6f 72 |(wide ar|ea infor|
|00003e80| 6d 61 74 69 6f 6e 20 73 | 6f 75 72 63 65 29 20 73 |mation s|ource) s|
|00003e90| 65 61 72 63 68 65 73 2e | 20 41 20 57 41 49 53 20 |earches.| A WAIS |
|00003ea0| 73 65 61 72 63 68 20 61 | 6c 6c 6f 77 73 20 79 6f |search a|llows yo|
|00003eb0| 75 20 74 6f 20 73 65 61 | 72 63 68 20 74 68 72 6f |u to sea|rch thro|
|00003ec0| 75 67 68 20 6d 61 74 65 | 72 69 61 6c 20 6f 6e 20 |ugh mate|rial on |
|00003ed0| 6f 75 74 73 69 64 65 20 | 73 6f 75 72 63 65 73 20 |outside |sources |
|00003ee0| 73 75 63 68 20 61 73 20 | 74 68 65 20 49 6e 74 65 |such as |the Inte|
|00003ef0| 72 6e 65 74 2e 0d 53 65 | 76 65 72 61 6c 20 6f 66 |rnet..Se|veral of|
|00003f00| 20 74 68 65 20 41 50 49 | 20 63 61 6c 6c 73 20 64 | the API| calls d|
|00003f10| 65 73 63 72 69 62 65 64 | 20 69 6e 20 74 68 69 73 |escribed| in this|
|00003f20| 20 64 6f 63 75 6d 65 6e | 74 20 61 72 65 20 72 65 | documen|t are re|
|00003f30| 6c 61 74 65 64 20 74 6f | 20 69 6e 66 6f 72 6d 61 |lated to| informa|
|00003f40| 74 69 6f 6e 20 73 6f 75 | 72 63 65 73 2e 20 46 6f |tion sou|rces. Fo|
|00003f50| 72 20 65 78 61 6d 70 6c | 65 2c 20 74 68 65 20 65 |r exampl|e, the e|
|00003f60| 6e 75 6d 65 72 61 74 65 | 2d 73 6f 75 72 63 65 73 |numerate|-sources|
|00003f70| 20 63 61 6c 6c 20 72 65 | 74 75 72 6e 73 20 61 20 | call re|turns a |
|00003f80| 6c 69 73 74 20 6f 66 20 | 69 6e 66 6f 72 6d 61 74 |list of |informat|
|00003f90| 69 6f 6e 20 73 6f 75 72 | 63 65 73 20 61 76 61 69 |ion sour|ces avai|
|00003fa0| 6c 61 62 6c 65 20 74 6f | 20 74 68 65 20 63 6c 69 |lable to| the cli|
|00003fb0| 65 6e 74 20 6f 6e 20 74 | 68 65 20 63 75 72 72 65 |ent on t|he curre|
|00003fc0| 6e 74 6c 79 20 63 6f 6e | 6e 65 63 74 65 64 20 73 |ntly con|nected s|
|00003fd0| 65 72 76 65 72 2e 20 0d | 4e 6f 74 65 3a 20 20 41 |erver. .|Note: A|
|00003fe0| 70 70 6c 65 53 65 61 72 | 63 68 20 72 61 6e 6b 73 |ppleSear|ch ranks|
|00003ff0| 20 61 72 74 69 63 6c 65 | 73 20 69 6e 20 74 65 72 | article|s in ter|
|00004000| 6d 73 20 6f 66 20 68 6f | 77 20 72 65 6c 65 76 61 |ms of ho|w releva|
|00004010| 6e 74 20 74 68 65 79 20 | 61 72 65 20 74 6f 20 61 |nt they |are to a|
|00004020| 20 75 73 65 72 d5 73 20 | 73 65 61 72 63 68 20 72 | user.s |search r|
|00004030| 65 71 75 65 73 74 2e 20 | 49 74 20 77 69 6c 6c 20 |equest. |It will |
|00004040| 72 61 6e 6b 20 74 68 65 | 20 61 72 74 69 63 6c 65 |rank the| article|
|00004050| 73 20 66 6f 72 20 65 61 | 63 68 20 69 6e 66 6f 72 |s for ea|ch infor|
|00004060| 6d 61 74 69 6f 6e 20 73 | 6f 75 72 63 65 3b 20 74 |mation s|ource; t|
|00004070| 68 61 74 20 69 73 2c 20 | 69 74 20 77 69 6c 6c 20 |hat is, |it will |
|00004080| 6e 6f 74 20 64 65 74 65 | 72 6d 69 6e 65 20 72 65 |not dete|rmine re|
|00004090| 6c 65 76 61 6e 63 79 20 | 61 63 72 6f 73 73 20 6d |levancy |across m|
|000040a0| 6f 72 65 20 74 68 61 6e | 20 6f 6e 65 20 69 6e 66 |ore than| one inf|
|000040b0| 6f 72 6d 61 74 69 6f 6e | 20 73 6f 75 72 63 65 20 |ormation| source |
|000040c0| 61 74 20 61 20 74 69 6d | 65 2e 20 0d 49 6d 6d 65 |at a tim|e. .Imme|
|000040d0| 64 69 61 74 65 20 73 65 | 61 72 63 68 65 73 0d 57 |diate se|arches.W|
|000040e0| 68 65 6e 20 61 6e 20 69 | 6d 6d 65 64 69 61 74 65 |hen an i|mmediate|
|000040f0| 20 73 65 61 72 63 68 20 | 69 73 20 69 6e 69 74 69 | search |is initi|
|00004100| 61 74 65 64 20 62 79 20 | 74 68 65 20 75 73 65 72 |ated by |the user|
|00004110| 2c 20 69 74 73 20 72 65 | 73 75 6c 74 73 20 61 72 |, its re|sults ar|
|00004120| 65 20 72 65 74 75 72 6e | 65 64 20 69 6d 6d 65 64 |e return|ed immed|
|00004130| 69 61 74 65 6c 79 20 62 | 79 20 74 68 65 20 73 65 |iately b|y the se|
|00004140| 72 76 65 72 2e 20 28 53 | 63 68 65 64 75 6c 65 64 |rver. (S|cheduled|
|00004150| 20 73 65 61 72 63 68 65 | 73 2c 20 77 68 69 63 68 | searche|s, which|
|00004160| 20 72 65 74 75 72 6e 20 | 72 65 73 75 6c 74 73 20 | return |results |
|00004170| 61 74 20 61 20 73 70 65 | 63 69 66 69 65 64 20 74 |at a spe|cified t|
|00004180| 69 6d 65 2c 20 61 72 65 | 20 64 69 73 63 75 73 73 |ime, are| discuss|
|00004190| 65 64 20 6c 61 74 65 72 | 20 69 6e 20 74 68 69 73 |ed later| in this|
|000041a0| 20 63 68 61 70 74 65 72 | 2e 29 20 54 6f 20 70 65 | chapter|.) To pe|
|000041b0| 72 66 6f 72 6d 20 61 6e | 20 69 6d 6d 65 64 69 61 |rform an| immedia|
|000041c0| 74 65 20 73 65 61 72 63 | 68 2c 20 79 6f 75 72 20 |te searc|h, your |
|000041d0| 61 70 70 6c 69 63 61 74 | 69 6f 6e 20 6d 75 73 74 |applicat|ion must|
|000041e0| 20 6d 61 6b 65 20 61 6e | 20 41 70 70 6c 65 53 65 | make an| AppleSe|
|000041f0| 61 72 63 68 20 6f 70 65 | 6e 2d 73 65 61 72 63 68 |arch ope|n-search|
|00004200| 2d 73 65 73 73 69 6f 6e | 20 63 61 6c 6c 20 74 6f |-session| call to|
|00004210| 20 6f 70 65 6e 20 61 20 | 73 65 61 72 63 68 20 73 | open a |search s|
|00004220| 65 73 73 69 6f 6e 2c 20 | 61 6e 64 20 74 68 65 6e |ession, |and then|
|00004230| 20 6d 61 6b 65 20 61 6e | 20 41 70 70 6c 65 53 65 | make an| AppleSe|
|00004240| 61 72 63 68 20 73 65 61 | 72 63 68 20 63 61 6c 6c |arch sea|rch call|
|00004250| 20 77 69 74 68 20 61 70 | 70 72 6f 70 72 69 61 74 | with ap|propriat|
|00004260| 65 20 70 61 72 61 6d 65 | 74 65 72 73 2e 20 59 6f |e parame|ters. Yo|
|00004270| 75 72 20 61 70 70 6c 69 | 63 61 74 69 6f 6e 20 63 |ur appli|cation c|
|00004280| 61 6e 20 6d 61 6b 65 20 | 61 73 20 6d 61 6e 79 20 |an make |as many |
|00004290| 73 65 61 72 63 68 20 63 | 61 6c 6c 73 20 61 73 20 |search c|alls as |
|000042a0| 79 6f 75 20 77 61 6e 74 | 20 77 69 74 68 69 6e 20 |you want| within |
|000042b0| 6f 6e 65 20 73 65 61 72 | 63 68 20 73 65 73 73 69 |one sear|ch sessi|
|000042c0| 6f 6e 20 61 6e 64 20 63 | 61 6e 20 61 6c 73 6f 20 |on and c|an also |
|000042d0| 6f 70 65 6e 20 61 73 20 | 6d 61 6e 79 20 73 65 61 |open as |many sea|
|000042e0| 72 63 68 20 73 65 73 73 | 69 6f 6e 73 20 73 69 6d |rch sess|ions sim|
|000042f0| 75 6c 74 61 6e 65 6f 75 | 73 6c 79 20 61 73 20 72 |ultaneou|sly as r|
|00004300| 65 73 6f 75 72 63 65 73 | 20 6f 6e 20 74 68 65 20 |esources| on the |
|00004310| 73 65 72 76 65 72 20 61 | 6c 6c 6f 77 2e 20 57 68 |server a|llow. Wh|
|00004320| 65 6e 20 79 6f 75 72 20 | 61 70 70 6c 69 63 61 74 |en your |applicat|
|00004330| 69 6f 6e 20 69 73 20 64 | 6f 6e 65 20 73 65 61 72 |ion is d|one sear|
|00004340| 63 68 69 6e 67 2c 20 79 | 6f 75 72 20 61 70 70 6c |ching, y|our appl|
|00004350| 69 63 61 74 69 6f 6e 20 | 6d 75 73 74 20 63 6c 6f |ication |must clo|
|00004360| 73 65 20 74 68 65 20 73 | 65 73 73 69 6f 6e 20 62 |se the s|ession b|
|00004370| 79 20 69 73 73 75 69 6e | 67 20 61 6e 20 41 70 70 |y issuin|g an App|
|00004380| 6c 65 53 65 61 72 63 68 | 20 63 6c 6f 73 65 2d 73 |leSearch| close-s|
|00004390| 65 61 72 63 68 2d 73 65 | 73 73 69 6f 6e 20 63 61 |earch-se|ssion ca|
|000043a0| 6c 6c 2e 20 0d 41 73 20 | 61 20 72 65 73 75 6c 74 |ll. .As |a result|
|000043b0| 20 6f 66 20 61 6e 20 69 | 6d 6d 65 64 69 61 74 65 | of an i|mmediate|
|000043c0| 20 73 65 61 72 63 68 2c | 20 74 68 65 20 73 65 72 | search,| the ser|
|000043d0| 76 65 72 20 72 65 74 75 | 72 6e 73 20 61 20 6c 69 |ver retu|rns a li|
|000043e0| 73 74 20 6f 66 20 61 72 | 74 69 63 6c 65 73 20 74 |st of ar|ticles t|
|000043f0| 68 61 74 20 6d 61 74 63 | 68 20 74 68 65 20 75 73 |hat matc|h the us|
|00004400| 65 72 d5 73 20 73 65 61 | 72 63 68 20 72 65 71 75 |er.s sea|rch requ|
|00004410| 65 73 74 2c 20 72 61 6e | 6b 65 64 20 69 6e 20 6f |est, ran|ked in o|
|00004420| 72 64 65 72 20 6f 66 20 | 72 65 6c 65 76 61 6e 63 |rder of |relevanc|
|00004430| 65 20 77 69 74 68 69 6e | 20 65 61 63 68 20 69 6e |e within| each in|
|00004440| 66 6f 72 6d 61 74 69 6f | 6e 20 73 6f 75 72 63 65 |formatio|n source|
|00004450| 2e 20 54 68 65 20 6c 69 | 73 74 20 73 68 6f 77 73 |. The li|st shows|
|00004460| 20 74 68 65 20 61 72 74 | 69 63 6c 65 20 49 44 2c | the art|icle ID,|
|00004470| 20 61 6c 6f 6e 67 20 77 | 69 74 68 20 69 74 73 20 | along w|ith its |
|00004480| 6d 6f 64 69 66 69 63 61 | 74 69 6f 6e 20 64 61 74 |modifica|tion dat|
|00004490| 65 2c 20 74 69 74 6c 65 | 2c 20 61 6e 64 20 66 69 |e, title|, and fi|
|000044a0| 6c 65 20 73 69 7a 65 2e | 20 54 6f 20 67 65 74 20 |le size.| To get |
|000044b0| 74 68 65 20 61 63 74 75 | 61 6c 20 61 72 74 69 63 |the actu|al artic|
|000044c0| 6c 65 20 74 65 78 74 20 | 6f 72 20 69 6e 66 6f 72 |le text |or infor|
|000044d0| 6d 61 74 69 6f 6e 20 61 | 62 6f 75 74 20 61 6e 20 |mation a|bout an |
|000044e0| 61 72 74 69 63 6c 65 2c | 20 79 6f 75 20 6d 75 73 |article,| you mus|
|000044f0| 74 20 6d 61 6b 65 20 73 | 65 70 61 72 61 74 65 20 |t make s|eparate |
|00004500| 63 61 6c 6c 73 2c 20 77 | 68 69 63 68 20 61 72 65 |calls, w|hich are|
|00004510| 20 64 65 73 63 72 69 62 | 65 64 20 69 6e 20 74 68 | describ|ed in th|
|00004520| 65 20 6e 65 78 74 20 73 | 65 63 74 69 6f 6e 2e 20 |e next s|ection. |
|00004530| 0d 41 72 74 69 63 6c 65 | 20 72 65 74 72 69 65 76 |.Article| retriev|
|00004540| 61 6c 0d 54 68 65 72 65 | 20 61 72 65 20 74 68 72 |al.There| are thr|
|00004550| 65 65 20 41 50 49 20 63 | 61 6c 6c 73 20 72 65 6c |ee API c|alls rel|
|00004560| 61 74 65 64 20 74 6f 20 | 61 72 74 69 63 6c 65 20 |ated to |article |
|00004570| 72 65 74 72 69 65 76 61 | 6c 3a 20 0d 6d 09 41 6e |retrieva|l: .m.An|
|00004580| 20 41 70 70 6c 65 53 65 | 61 72 63 68 20 67 65 74 | AppleSe|arch get|
|00004590| 2d 61 72 74 69 63 6c 65 | 2d 74 65 78 74 20 63 61 |-article|-text ca|
|000045a0| 6c 6c 20 72 65 74 75 72 | 6e 73 20 74 68 65 20 74 |ll retur|ns the t|
|000045b0| 65 78 74 20 6f 66 20 61 | 6e 20 61 72 74 69 63 6c |ext of a|n articl|
|000045c0| 65 2e 0d 6d 09 41 6e 20 | 41 70 70 6c 65 53 65 61 |e..m.An |AppleSea|
|000045d0| 72 63 68 20 67 65 74 2d | 61 72 74 69 63 6c 65 2d |rch get-|article-|
|000045e0| 69 6e 66 6f 20 63 61 6c | 6c 20 72 65 74 75 72 6e |info cal|l return|
|000045f0| 73 20 61 6e 20 61 72 74 | 69 63 6c 65 d5 73 20 61 |s an art|icle.s a|
|00004600| 74 74 72 69 62 75 74 65 | 73 20 73 75 63 68 20 61 |ttribute|s such a|
|00004610| 73 20 69 74 73 20 6d 6f | 64 69 66 69 63 61 74 69 |s its mo|dificati|
|00004620| 6f 6e 20 64 61 74 65 2c | 20 74 69 74 6c 65 2c 20 |on date,| title, |
|00004630| 61 6e 64 20 73 69 7a 65 | 2e 0d 6d 09 41 6e 20 41 |and size|..m.An A|
|00004640| 70 70 6c 65 53 65 61 72 | 63 68 20 67 65 74 2d 61 |ppleSear|ch get-a|
|00004650| 72 74 69 63 6c 65 2d 6d | 61 74 63 68 65 73 20 63 |rticle-m|atches c|
|00004660| 61 6c 6c 20 72 65 74 75 | 72 6e 73 20 61 20 6c 69 |all retu|rns a li|
|00004670| 73 74 20 6f 66 20 6f 66 | 66 73 65 74 73 20 61 6e |st of of|fsets an|
|00004680| 64 20 6c 65 6e 67 74 68 | 73 2c 20 77 68 69 63 68 |d length|s, which|
|00004690| 20 72 65 70 72 65 73 65 | 6e 74 20 74 68 65 20 77 | represe|nt the w|
|000046a0| 6f 72 64 73 20 6d 61 74 | 63 68 69 6e 67 20 74 68 |ords mat|ching th|
|000046b0| 65 20 6f 72 69 67 69 6e | 61 6c 20 71 75 65 72 79 |e origin|al query|
|000046c0| 20 28 75 73 65 64 20 66 | 6f 72 20 74 68 65 20 68 | (used f|or the h|
|000046d0| 69 67 68 6c 69 67 68 74 | 20 6d 61 74 63 68 69 6e |ighlight| matchin|
|000046e0| 67 20 77 6f 72 64 73 20 | 66 65 61 74 75 72 65 20 |g words |feature |
|000046f0| 69 6e 20 74 68 65 20 41 | 70 70 6c 65 53 65 61 72 |in the A|ppleSear|
|00004700| 63 68 20 43 6c 69 65 6e | 74 20 73 6f 66 74 77 61 |ch Clien|t softwa|
|00004710| 72 65 29 2e 20 54 68 69 | 73 20 6c 69 73 74 20 69 |re). Thi|s list i|
|00004720| 73 20 6e 6f 74 20 72 65 | 74 75 72 6e 65 64 20 69 |s not re|turned i|
|00004730| 6e 20 74 68 65 20 63 61 | 73 65 20 6f 66 20 61 20 |n the ca|se of a |
|00004740| 57 41 49 53 20 73 65 61 | 72 63 68 2e 0d 54 6f 20 |WAIS sea|rch..To |
|00004750| 6d 61 6b 65 20 74 68 65 | 73 65 20 63 61 6c 6c 73 |make the|se calls|
|00004760| 2c 20 79 6f 75 72 20 61 | 70 70 6c 69 63 61 74 69 |, your a|pplicati|
|00004770| 6f 6e 20 6d 75 73 74 20 | 68 61 76 65 20 74 68 65 |on must |have the|
|00004780| 20 61 72 74 69 63 6c 65 | d5 73 20 69 6e 66 6f 72 | article|.s infor|
|00004790| 6d 61 74 69 6f 6e 20 73 | 6f 75 72 63 65 20 49 44 |mation s|ource ID|
|000047a0| 20 61 6e 64 20 61 72 74 | 69 63 6c 65 20 49 44 2c | and art|icle ID,|
|000047b0| 20 62 6f 74 68 20 6f 66 | 20 77 68 69 63 68 20 61 | both of| which a|
|000047c0| 72 65 20 72 65 74 75 72 | 6e 65 64 20 62 79 20 61 |re retur|ned by a|
|000047d0| 20 73 65 61 72 63 68 20 | 63 61 6c 6c 2e 20 41 6c | search |call. Al|
|000047e0| 73 6f 2c 20 74 6f 20 67 | 65 74 20 6d 61 74 63 68 |so, to g|et match|
|000047f0| 65 73 2c 20 79 6f 75 20 | 6d 75 73 74 20 68 61 76 |es, you |must hav|
|00004800| 65 20 61 20 73 65 61 72 | 63 68 20 73 65 73 73 69 |e a sear|ch sessi|
|00004810| 6f 6e 20 49 44 20 66 6f | 72 20 74 68 65 20 73 65 |on ID fo|r the se|
|00004820| 61 72 63 68 20 73 65 73 | 73 69 6f 6e 20 77 68 69 |arch ses|sion whi|
|00004830| 63 68 20 74 68 65 20 61 | 72 74 69 63 6c 65 20 77 |ch the a|rticle w|
|00004840| 61 73 20 66 6f 75 6e 64 | 2c 20 61 6e 64 20 74 68 |as found|, and th|
|00004850| 65 20 73 65 61 72 63 68 | 20 65 6e 67 69 6e 65 20 |e search| engine |
|00004860| 6d 75 73 74 20 62 65 20 | 6f 70 65 6e 2e 20 0d 4f |must be |open. .O|
|00004870| 72 69 67 69 6e 61 6c 20 | 66 69 6c 65 20 72 65 74 |riginal |file ret|
|00004880| 72 69 65 76 61 6c 0d 57 | 68 65 6e 20 41 70 70 6c |rieval.W|hen Appl|
|00004890| 65 53 65 61 72 63 68 20 | 72 65 74 72 69 65 76 65 |eSearch |retrieve|
|000048a0| 73 20 61 72 74 69 63 6c | 65 73 2c 20 69 74 20 65 |s articl|es, it e|
|000048b0| 78 74 72 61 63 74 73 20 | 70 6c 61 69 6e 20 74 65 |xtracts |plain te|
|000048c0| 78 74 20 66 72 6f 6d 20 | 76 61 72 69 6f 75 73 20 |xt from |various |
|000048d0| 64 6f 63 75 6d 65 6e 74 | 20 74 79 70 65 73 2c 20 |document| types, |
|000048e0| 69 67 6e 6f 72 69 6e 67 | 20 67 72 61 70 68 69 63 |ignoring| graphic|
|000048f0| 73 20 61 6e 64 20 66 6f | 72 6d 61 74 74 69 6e 67 |s and fo|rmatting|
|00004900| 20 69 6e 73 74 72 75 63 | 74 69 6f 6e 73 2e 20 54 | instruc|tions. T|
|00004910| 68 65 20 74 65 78 74 20 | 6f 66 20 65 61 63 68 20 |he text |of each |
|00004920| 61 72 74 69 63 6c 65 20 | 69 73 20 72 65 74 75 72 |article |is retur|
|00004930| 6e 65 64 20 74 6f 20 74 | 68 65 20 63 6c 69 65 6e |ned to t|he clien|
|00004940| 74 20 62 79 20 6d 65 61 | 6e 73 20 6f 66 20 69 6e |t by mea|ns of in|
|00004950| 64 69 76 69 64 75 61 6c | 20 63 61 6c 6c 73 20 74 |dividual| calls t|
|00004960| 6f 20 61 20 67 65 74 2d | 61 72 74 69 63 6c 65 2d |o a get-|article-|
|00004970| 74 65 78 74 20 63 61 6c | 6c 2e 20 54 68 65 20 73 |text cal|l. The s|
|00004980| 65 72 76 65 72 20 75 73 | 65 73 20 58 54 4e 44 20 |erver us|es XTND |
|00004990| 66 69 6c 65 2d 66 6f 72 | 6d 61 74 20 74 72 61 6e |file-for|mat tran|
|000049a0| 73 6c 61 74 6f 72 73 20 | 74 6f 20 65 78 74 72 61 |slators |to extra|
|000049b0| 63 74 20 74 68 65 20 74 | 65 78 74 2e 20 0d 0d 41 |ct the t|ext. ..A|
|000049c0| 20 67 65 74 2d 6f 72 69 | 67 69 6e 61 6c 2d 66 69 | get-ori|ginal-fi|
|000049d0| 6c 65 20 63 61 6c 6c 20 | 61 6c 6c 6f 77 73 20 79 |le call |allows y|
|000049e0| 6f 75 20 74 6f 20 72 65 | 74 72 69 65 76 65 20 61 |ou to re|trieve a|
|000049f0| 6e 20 61 72 74 69 63 6c | 65 20 69 6e 20 69 74 73 |n articl|e in its|
|00004a00| 20 6f 72 69 67 69 6e 61 | 6c 20 66 6f 72 6d 61 74 | origina|l format|
|00004a10| 2e 20 46 6f 72 20 69 6e | 73 74 61 6e 63 65 2c 20 |. For in|stance, |
|00004a20| 69 66 20 74 68 65 20 6f | 72 69 67 69 6e 61 6c 20 |if the o|riginal |
|00004a30| 61 72 74 69 63 6c 65 20 | 6f 6e 20 74 68 65 20 73 |article |on the s|
|00004a40| 65 72 76 65 72 20 77 61 | 73 20 66 6f 72 6d 61 74 |erver wa|s format|
|00004a50| 74 65 64 20 77 69 74 68 | 20 4d 61 63 57 72 69 74 |ted with| MacWrit|
|00004a60| 65 2c 20 61 20 67 65 74 | 2d 6f 72 69 67 69 6e 61 |e, a get|-origina|
|00004a70| 6c 2d 66 69 6c 65 20 63 | 61 6c 6c 20 77 6f 75 6c |l-file c|all woul|
|00004a80| 64 20 72 65 74 72 69 65 | 76 65 20 74 68 65 20 61 |d retrie|ve the a|
|00004a90| 72 74 69 63 6c 65 20 61 | 73 20 61 20 4d 61 63 57 |rticle a|s a MacW|
|00004aa0| 72 69 74 65 20 64 6f 63 | 75 6d 65 6e 74 2e 20 54 |rite doc|ument. T|
|00004ab0| 6f 20 6d 61 6b 65 20 74 | 68 69 73 20 63 61 6c 6c |o make t|his call|
|00004ac0| 2c 20 79 6f 75 72 20 61 | 70 70 6c 69 63 61 74 69 |, your a|pplicati|
|00004ad0| 6f 6e 20 6e 65 65 64 73 | 20 74 68 65 20 61 72 74 |on needs| the art|
|00004ae0| 69 63 6c 65 d5 73 20 69 | 6e 66 6f 72 6d 61 74 69 |icle.s i|nformati|
|00004af0| 6f 6e 20 73 6f 75 72 63 | 65 20 49 44 20 61 6e 64 |on sourc|e ID and|
|00004b00| 20 61 72 74 69 63 6c 65 | 20 49 44 2e 20 0d 53 63 | article| ID. .Sc|
|00004b10| 68 65 64 75 6c 65 64 20 | 73 65 61 72 63 68 65 73 |heduled |searches|
|00004b20| 0d 52 65 70 6f 72 74 65 | 72 73 20 61 72 65 20 71 |.Reporte|rs are q|
|00004b30| 75 65 72 69 65 73 20 74 | 68 61 74 20 61 72 65 20 |ueries t|hat are |
|00004b40| 73 61 76 65 64 20 77 69 | 74 68 20 70 61 72 61 6d |saved wi|th param|
|00004b50| 65 74 65 72 73 20 73 70 | 65 63 69 66 69 65 64 20 |eters sp|ecified |
|00004b60| 62 79 20 74 68 65 20 75 | 73 65 72 2e 20 54 68 65 |by the u|ser. The|
|00004b70| 79 20 61 72 65 20 73 74 | 6f 72 65 64 20 61 73 20 |y are st|ored as |
|00004b80| 64 61 74 61 62 61 73 65 | 20 6f 62 6a 65 63 74 73 |database| objects|
|00004b90| 20 6f 6e 20 74 68 65 20 | 73 65 72 76 65 72 2e 20 | on the |server. |
|00004ba0| 28 53 65 65 20 74 68 65 | 20 6e 65 78 74 20 73 65 |(See the| next se|
|00004bb0| 63 74 69 6f 6e 20 66 6f | 72 20 6d 6f 72 65 20 69 |ction fo|r more i|
|00004bc0| 6e 66 6f 72 6d 61 74 69 | 6f 6e 20 61 62 6f 75 74 |nformati|on about|
|00004bd0| 20 64 61 74 61 62 61 73 | 65 20 6f 62 6a 65 63 74 | databas|e object|
|00004be0| 73 2e 29 20 45 61 63 68 | 20 72 65 70 6f 72 74 65 |s.) Each| reporte|
|00004bf0| 72 20 6f 62 6a 65 63 74 | 20 63 6f 6e 74 61 69 6e |r object| contain|
|00004c00| 73 20 69 74 73 20 73 65 | 61 72 63 68 20 71 75 65 |s its se|arch que|
|00004c10| 72 79 2c 20 69 6e 66 6f | 72 6d 61 74 69 6f 6e 20 |ry, info|rmation |
|00004c20| 73 6f 75 72 63 65 73 20 | 74 6f 20 73 65 61 72 63 |sources |to searc|
|00004c30| 68 2c 20 6f 74 68 65 72 | 20 73 65 61 72 63 68 20 |h, other| search |
|00004c40| 6f 70 74 69 6f 6e 73 2c | 20 61 6e 64 20 69 74 73 |options,| and its|
|00004c50| 20 64 65 6c 69 76 65 72 | 79 20 64 61 74 65 2c 20 | deliver|y date, |
|00004c60| 74 69 6d 65 2c 20 61 6e | 64 20 75 70 64 61 74 65 |time, an|d update|
|00004c70| 20 66 69 6c 65 20 64 65 | 73 74 69 6e 61 74 69 6f | file de|stinatio|
|00004c80| 6e 2e 20 54 68 65 20 41 | 70 70 6c 65 53 65 61 72 |n. The A|ppleSear|
|00004c90| 63 68 20 43 6c 69 65 6e | 74 20 4c 69 62 72 61 72 |ch Clien|t Librar|
|00004ca0| 79 20 72 65 74 72 69 65 | 76 65 73 20 72 65 70 6f |y retrie|ves repo|
|00004cb0| 72 74 65 72 20 6f 62 6a | 65 63 74 20 69 6e 66 6f |rter obj|ect info|
|00004cc0| 72 6d 61 74 69 6f 6e 20 | 66 72 6f 6d 20 74 68 65 |rmation |from the|
|00004cd0| 20 73 65 72 76 65 72 20 | 69 6e 20 6f 72 64 65 72 | server |in order|
|00004ce0| 20 74 6f 20 64 65 6c 69 | 76 65 72 20 75 70 64 61 | to deli|ver upda|
|00004cf0| 74 65 73 20 6f 72 20 74 | 6f 20 61 6c 6c 6f 77 20 |tes or t|o allow |
|00004d00| 75 73 65 72 73 20 74 6f | 20 6d 6f 64 69 66 79 20 |users to| modify |
|00004d10| 74 68 65 20 6f 62 6a 65 | 63 74 20 69 6e 66 6f 72 |the obje|ct infor|
|00004d20| 6d 61 74 69 6f 6e 2e 20 | 0d 59 6f 75 72 20 61 70 |mation. |.Your ap|
|00004d30| 70 6c 69 63 61 74 69 6f | 6e 20 63 61 6e 20 75 73 |plicatio|n can us|
|00004d40| 65 20 41 50 49 20 63 61 | 6c 6c 73 20 74 6f 20 61 |e API ca|lls to a|
|00004d50| 64 64 2c 20 64 65 6c 65 | 74 65 2c 20 6f 72 20 6d |dd, dele|te, or m|
|00004d60| 6f 64 69 66 79 20 72 65 | 70 6f 72 74 65 72 73 2c |odify re|porters,|
|00004d70| 20 6f 72 20 74 6f 20 67 | 65 74 20 72 65 70 6f 72 | or to g|et repor|
|00004d80| 74 65 72 20 6f 62 6a 65 | 63 74 73 20 66 72 6f 6d |ter obje|cts from|
|00004d90| 20 61 6e 64 20 74 6f 20 | 74 68 65 20 73 65 72 76 | and to |the serv|
|00004da0| 65 72 2e 20 45 61 63 68 | 20 72 65 70 6f 72 74 65 |er. Each| reporte|
|00004db0| 72 20 63 61 6e 20 62 65 | 20 61 63 74 69 76 65 20 |r can be| active |
|00004dc0| 6f 72 20 69 6e 61 63 74 | 69 76 65 3b 20 6f 6e 6c |or inact|ive; onl|
|00004dd0| 79 20 74 68 6f 73 65 20 | 72 65 70 6f 72 74 65 72 |y those |reporter|
|00004de0| 73 20 74 68 61 74 20 61 | 72 65 20 61 63 74 69 76 |s that a|re activ|
|00004df0| 65 20 64 65 6c 69 76 65 | 72 20 75 70 64 61 74 65 |e delive|r update|
|00004e00| 73 2e 20 54 68 65 20 61 | 63 74 69 76 65 20 66 6c |s. The a|ctive fl|
|00004e10| 61 67 20 69 73 20 6f 6e | 65 20 6f 66 20 74 68 65 |ag is on|e of the|
|00004e20| 20 72 65 70 6f 72 74 65 | 72 20 6f 62 6a 65 63 74 | reporte|r object|
|00004e30| 20 61 74 74 72 69 62 75 | 74 65 73 20 61 6e 64 20 | attribu|tes and |
|00004e40| 63 61 6e 20 62 65 20 73 | 65 74 20 62 79 20 61 6e |can be s|et by an|
|00004e50| 20 41 70 70 6c 65 53 65 | 61 72 63 68 20 6d 6f 64 | AppleSe|arch mod|
|00004e60| 69 66 79 2d 72 65 70 6f | 72 74 65 72 20 63 61 6c |ify-repo|rter cal|
|00004e70| 6c 2e 20 0d 53 65 72 76 | 65 72 20 6f 62 6a 65 63 |l. .Serv|er objec|
|00004e80| 74 20 64 61 74 61 62 61 | 73 65 0d 54 68 65 20 41 |t databa|se.The A|
|00004e90| 70 70 6c 65 53 65 61 72 | 63 68 20 73 65 72 76 65 |ppleSear|ch serve|
|00004ea0| 72 20 6d 61 69 6e 74 61 | 69 6e 73 20 61 20 64 61 |r mainta|ins a da|
|00004eb0| 74 61 62 61 73 65 2c 20 | 63 61 6c 6c 65 64 20 74 |tabase, |called t|
|00004ec0| 68 65 20 73 65 72 76 65 | 72 20 6f 62 6a 65 63 74 |he serve|r object|
|00004ed0| 20 64 61 74 61 62 61 73 | 65 2c 20 74 68 61 74 20 | databas|e, that |
|00004ee0| 73 74 6f 72 65 73 20 61 | 20 6c 69 73 74 20 6f 66 |stores a| list of|
|00004ef0| 20 72 65 70 6f 72 74 65 | 72 73 20 61 6e 64 20 6f | reporte|rs and o|
|00004f00| 74 68 65 72 20 72 65 6c | 65 76 61 6e 74 20 69 6e |ther rel|evant in|
|00004f10| 66 6f 72 6d 61 74 69 6f | 6e 2e 20 59 6f 75 72 20 |formatio|n. Your |
|00004f20| 61 70 70 6c 69 63 61 74 | 69 6f 6e 20 63 61 6e 20 |applicat|ion can |
|00004f30| 75 73 65 20 74 68 69 73 | 20 64 61 74 61 62 61 73 |use this| databas|
|00004f40| 65 20 74 6f 20 73 74 6f | 72 65 20 63 75 73 74 6f |e to sto|re custo|
|00004f50| 6d 20 69 6e 66 6f 72 6d | 61 74 69 6f 6e 2e 20 41 |m inform|ation. A|
|00004f60| 20 73 65 74 20 6f 66 20 | 72 6f 75 74 69 6e 65 73 | set of |routines|
|00004f70| 20 69 73 20 70 72 6f 76 | 69 64 65 64 20 74 6f 20 | is prov|ided to |
|00004f80| 61 6c 6c 6f 77 20 79 6f | 75 72 20 61 70 70 6c 69 |allow yo|ur appli|
|00004f90| 63 61 74 69 6f 6e 20 74 | 6f 20 67 61 69 6e 20 61 |cation t|o gain a|
|00004fa0| 63 63 65 73 73 20 74 6f | 20 74 68 65 20 64 61 74 |ccess to| the dat|
|00004fb0| 61 62 61 73 65 2e 20 46 | 6f 72 20 69 6e 73 74 61 |abase. F|or insta|
|00004fc0| 6e 63 65 2c 20 61 6e 20 | 61 64 64 2d 6f 62 6a 65 |nce, an |add-obje|
|00004fd0| 63 74 20 63 61 6c 6c 20 | 61 64 64 73 20 63 75 73 |ct call |adds cus|
|00004fe0| 74 6f 6d 20 6f 62 6a 65 | 63 74 73 20 74 6f 20 74 |tom obje|cts to t|
|00004ff0| 68 65 20 63 75 72 72 65 | 6e 74 6c 79 20 63 6f 6e |he curre|ntly con|
|00005000| 6e 65 63 74 65 64 20 73 | 65 72 76 65 72 d5 73 20 |nected s|erver.s |
|00005010| 6f 62 6a 65 63 74 20 64 | 61 74 61 62 61 73 65 2c |object d|atabase,|
|00005020| 20 61 6e 64 20 61 6e 20 | 65 6e 75 6d 65 72 61 74 | and an |enumerat|
|00005030| 65 2d 6f 62 6a 65 63 74 | 73 20 63 61 6c 6c 20 6c |e-object|s call l|
|00005040| 69 73 74 73 20 61 6c 6c | 20 6f 62 6a 65 63 74 73 |ists all| objects|
|00005050| 20 6f 66 20 61 20 73 70 | 65 63 69 66 69 63 20 74 | of a sp|ecific t|
|00005060| 79 70 65 20 69 6e 20 74 | 68 65 20 64 61 74 61 62 |ype in t|he datab|
|00005070| 61 73 65 2e 20 41 20 64 | 61 74 61 62 61 73 65 20 |ase. A d|atabase |
|00005080| 6f 62 6a 65 63 74 20 73 | 74 6f 72 65 64 20 62 79 |object s|tored by|
|00005090| 20 6f 6e 65 20 72 65 67 | 69 73 74 65 72 65 64 20 | one reg|istered |
|000050a0| 75 73 65 72 20 69 73 20 | 61 63 63 65 73 73 69 62 |user is |accessib|
|000050b0| 6c 65 20 6f 6e 6c 79 20 | 62 79 20 74 68 61 74 20 |le only |by that |
|000050c0| 75 73 65 72 2e 20 0d 4e | 6f 74 65 3a 20 20 49 6e |user. .N|ote: In|
|000050d0| 74 65 72 6e 61 6c 6c 79 | 2c 20 61 20 72 65 70 6f |ternally|, a repo|
|000050e0| 72 74 65 72 20 69 73 20 | 61 20 73 70 65 63 69 61 |rter is |a specia|
|000050f0| 6c 20 6b 69 6e 64 20 6f | 66 20 6f 62 6a 65 63 74 |l kind o|f object|
|00005100| 20 74 68 61 74 20 74 68 | 65 20 41 70 70 6c 65 53 | that th|e AppleS|
|00005110| 65 61 72 63 68 20 43 6c | 69 65 6e 74 20 4c 69 62 |earch Cl|ient Lib|
|00005120| 72 61 72 79 20 75 73 65 | 73 2e 20 41 6e 20 6f 62 |rary use|s. An ob|
|00005130| 6a 65 63 74 20 69 73 20 | 61 6e 79 20 63 68 75 6e |ject is |any chun|
|00005140| 6b 20 6f 66 20 69 6e 66 | 6f 72 6d 61 74 69 6f 6e |k of inf|ormation|
|00005150| d1 62 61 73 69 63 61 6c | 6c 79 2c 20 61 6e 20 61 |.basical|ly, an a|
|00005160| 72 72 61 79 20 6f 66 20 | 62 79 74 65 73 d1 77 69 |rray of |bytes.wi|
|00005170| 74 68 20 61 20 74 79 70 | 65 20 61 6e 64 20 49 44 |th a typ|e and ID|
|00005180| 2e 20 45 61 63 68 20 6f | 62 6a 65 63 74 20 6f 66 |. Each o|bject of|
|00005190| 20 74 68 65 20 73 61 6d | 65 20 74 79 70 65 20 69 | the sam|e type i|
|000051a0| 6e 20 74 68 65 20 64 61 | 74 61 62 61 73 65 20 6d |n the da|tabase m|
|000051b0| 75 73 74 20 68 61 76 65 | 20 61 20 75 6e 69 71 75 |ust have| a uniqu|
|000051c0| 65 20 49 44 20 66 6f 72 | 20 65 61 63 68 20 72 65 |e ID for| each re|
|000051d0| 67 69 73 74 65 72 65 64 | 20 75 73 65 72 2e 20 0d |gistered| user. .|
|000051e0| 0d 0d 32 09 41 70 70 6c | 65 20 45 76 65 6e 74 73 |..2.Appl|e Events|
|000051f0| 20 41 70 70 6c 69 63 61 | 74 69 6f 6e 20 50 72 6f | Applica|tion Pro|
|00005200| 67 72 61 6d 6d 69 6e 67 | 20 49 6e 74 65 72 66 61 |gramming| Interfa|
|00005210| 63 65 0d 54 68 69 73 20 | 63 68 61 70 74 65 72 20 |ce.This |chapter |
|00005220| 64 65 73 63 72 69 62 65 | 73 20 74 68 65 20 41 70 |describe|s the Ap|
|00005230| 70 6c 65 20 65 76 65 6e | 74 73 20 61 70 70 6c 69 |ple even|ts appli|
|00005240| 63 61 74 69 6f 6e 20 70 | 72 6f 67 72 61 6d 6d 69 |cation p|rogrammi|
|00005250| 6e 67 20 69 6e 74 65 72 | 66 61 63 65 20 28 41 50 |ng inter|face (AP|
|00005260| 49 29 20 70 72 6f 76 69 | 64 65 64 20 62 79 20 41 |I) provi|ded by A|
|00005270| 70 70 6c 65 53 65 61 72 | 63 68 2e 20 49 74 20 64 |ppleSear|ch. It d|
|00005280| 65 73 63 72 69 62 65 73 | 20 68 6f 77 20 74 6f 20 |escribes| how to |
|00005290| 75 73 65 20 74 68 65 20 | 41 50 49 20 61 6e 64 20 |use the |API and |
|000052a0| 74 68 65 6e 20 67 69 76 | 65 73 20 61 20 64 65 74 |then giv|es a det|
|000052b0| 61 69 6c 65 64 20 73 70 | 65 63 69 66 69 63 61 74 |ailed sp|ecificat|
|000052c0| 69 6f 6e 20 66 6f 72 20 | 65 61 63 68 20 41 70 70 |ion for |each App|
|000052d0| 6c 65 20 65 76 65 6e 74 | 2e 0d 4e 6f 74 65 3a 20 |le event|..Note: |
|000052e0| 20 49 6e 20 41 70 70 6c | 65 53 65 61 72 63 68 2c | In Appl|eSearch,|
|000052f0| 20 74 68 65 20 41 70 70 | 6c 65 53 65 61 72 63 68 | the App|leSearch|
|00005300| 20 63 6c 69 65 6e 74 20 | 75 73 65 73 20 41 70 70 | client |uses App|
|00005310| 6c 65 20 65 76 65 6e 74 | 73 20 61 73 20 61 20 70 |le event|s as a p|
|00005320| 72 69 76 61 74 65 2c 20 | 69 6e 74 65 72 61 70 70 |rivate, |interapp|
|00005330| 6c 69 63 61 74 69 6f 6e | 20 74 72 61 6e 73 70 6f |lication| transpo|
|00005340| 72 74 20 6d 65 63 68 61 | 6e 69 73 6d 20 66 6f 72 |rt mecha|nism for|
|00005350| 20 61 63 63 65 73 73 69 | 6e 67 20 74 68 65 20 41 | accessi|ng the A|
|00005360| 70 70 6c 65 53 65 61 72 | 63 68 20 43 6f 6d 6d 75 |ppleSear|ch Commu|
|00005370| 6e 69 63 61 74 69 6f 6e | 20 45 78 74 65 6e 73 69 |nication| Extensi|
|00005380| 6f 6e 20 41 50 49 2e 20 | 54 68 75 73 2c 20 41 70 |on API. |Thus, Ap|
|00005390| 70 6c 65 53 65 61 72 63 | 68 20 64 6f 65 73 20 6e |pleSearc|h does n|
|000053a0| 6f 74 20 73 75 70 70 6f | 72 74 20 74 68 65 20 4f |ot suppo|rt the O|
|000053b0| 62 6a 65 63 74 20 53 75 | 70 70 6f 72 74 20 4c 69 |bject Su|pport Li|
|000053c0| 62 72 61 72 79 2c 20 6e | 6f 72 20 64 6f 65 73 20 |brary, n|or does |
|000053d0| 69 74 20 65 73 74 61 62 | 6c 69 73 68 20 61 20 73 |it estab|lish a s|
|000053e0| 74 61 6e 64 61 72 64 20 | 69 6e 66 6f 72 6d 61 74 |tandard |informat|
|000053f0| 69 6f 6e 20 61 63 63 65 | 73 73 20 73 75 69 74 65 |ion acce|ss suite|
|00005400| 2e 0d 53 65 6e 64 69 6e | 67 20 61 6e 64 20 72 65 |..Sendin|g and re|
|00005410| 63 65 69 76 69 6e 67 20 | 41 70 70 6c 65 53 65 61 |ceiving |AppleSea|
|00005420| 72 63 68 20 41 70 70 6c | 65 20 65 76 65 6e 74 73 |rch Appl|e events|
|00005430| 0d 45 61 63 68 20 41 70 | 70 6c 65 53 65 61 72 63 |.Each Ap|pleSearc|
|00005440| 68 20 72 65 71 75 65 73 | 74 20 69 73 20 61 6e 20 |h reques|t is an |
|00005450| 41 70 70 6c 65 20 65 76 | 65 6e 74 20 74 68 61 74 |Apple ev|ent that|
|00005460| 20 79 6f 75 72 20 61 70 | 70 6c 69 63 61 74 69 6f | your ap|plicatio|
|00005470| 6e 20 6d 75 73 74 20 73 | 65 6e 64 20 74 6f 20 74 |n must s|end to t|
|00005480| 68 65 20 41 70 70 6c 65 | 53 65 61 72 63 68 20 43 |he Apple|Search C|
|00005490| 6f 6d 6d 75 6e 69 63 61 | 74 69 6f 6e 20 45 78 74 |ommunica|tion Ext|
|000054a0| 65 6e 73 69 6f 6e 2e 20 | 59 6f 75 20 63 61 6e 20 |ension. |You can |
|000054b0| 73 70 65 63 69 66 79 20 | 74 68 65 20 41 70 70 6c |specify |the Appl|
|000054c0| 65 53 65 61 72 63 68 20 | 43 6f 6d 6d 75 6e 69 63 |eSearch |Communic|
|000054d0| 61 74 69 6f 6e 20 45 78 | 74 65 6e 73 69 6f 6e 20 |ation Ex|tension |
|000054e0| 62 79 20 69 74 73 20 63 | 72 65 61 74 6f 72 20 74 |by its c|reator t|
|000054f0| 79 70 65 2c 20 77 68 69 | 63 68 20 69 73 20 6b 41 |ype, whi|ch is kA|
|00005500| 70 70 6c 65 53 65 61 72 | 63 68 43 6f 6d 6d 75 6e |ppleSear|chCommun|
|00005510| 69 63 61 74 69 6f 6e 53 | 69 67 6e 61 74 75 72 65 |icationS|ignature|
|00005520| 2e 20 54 68 65 20 65 76 | 65 6e 74 20 63 6c 61 73 |. The ev|ent clas|
|00005530| 73 20 6f 66 20 74 68 65 | 20 72 65 71 75 65 73 74 |s of the| request|
|00005540| 20 73 68 6f 75 6c 64 20 | 62 65 20 6b 41 70 70 6c | should |be kAppl|
|00005550| 65 53 65 61 72 63 68 52 | 65 71 75 65 73 74 2e 20 |eSearchR|equest. |
|00005560| 59 6f 75 72 20 61 70 70 | 6c 69 63 61 74 69 6f 6e |Your app|lication|
|00005570| 20 63 61 6e 20 73 65 6e | 64 20 69 74 20 69 6e 20 | can sen|d it in |
|00005580| 61 6e 79 20 6d 6f 64 65 | 20 79 6f 75 20 70 72 65 |any mode| you pre|
|00005590| 66 65 72 d1 66 6f 72 20 | 65 78 61 6d 70 6c 65 2c |fer.for |example,|
|000055a0| 20 6b 41 45 51 75 65 75 | 65 52 65 70 6c 79 20 6f | kAEQueu|eReply o|
|000055b0| 72 20 6b 41 45 57 61 69 | 74 52 65 70 6c 79 2e 20 |r kAEWai|tReply. |
|000055c0| 42 6f 74 68 20 74 68 65 | 20 63 72 65 61 74 6f 72 |Both the| creator|
|000055d0| 20 74 79 70 65 20 61 6e | 64 20 65 76 65 6e 74 20 | type an|d event |
|000055e0| 63 6c 61 73 73 20 61 72 | 65 20 64 65 66 69 6e 65 |class ar|e define|
|000055f0| 64 20 69 6e 20 74 68 65 | 20 68 65 61 64 65 72 20 |d in the| header |
|00005600| 66 69 6c 65 20 41 70 70 | 6c 65 53 65 61 72 63 68 |file App|leSearch|
|00005610| 41 45 41 50 49 2e 68 2e | 20 0d 57 68 65 6e 20 74 |AEAPI.h.| .When t|
|00005620| 68 65 20 41 70 70 6c 65 | 53 65 61 72 63 68 20 43 |he Apple|Search C|
|00005630| 6f 6d 6d 75 6e 69 63 61 | 74 69 6f 6e 20 45 78 74 |ommunica|tion Ext|
|00005640| 65 6e 73 69 6f 6e 20 72 | 65 63 65 69 76 65 73 20 |ension r|eceives |
|00005650| 61 20 72 65 71 75 65 73 | 74 20 66 72 6f 6d 20 79 |a reques|t from y|
|00005660| 6f 75 72 20 61 70 70 6c | 69 63 61 74 69 6f 6e 2c |our appl|ication,|
|00005670| 20 69 74 20 73 65 6e 64 | 73 20 61 20 72 65 71 75 | it send|s a requ|
|00005680| 65 73 74 20 74 6f 20 61 | 20 73 65 72 76 65 72 20 |est to a| server |
|00005690| 61 73 79 6e 63 68 72 6f | 6e 6f 75 73 6c 79 2e 20 |asynchro|nously. |
|000056a0| 57 68 65 6e 20 61 20 72 | 65 70 6c 79 20 63 6f 6d |When a r|eply com|
|000056b0| 65 73 20 62 61 63 6b 20 | 66 72 6f 6d 20 74 68 65 |es back |from the|
|000056c0| 20 73 65 72 76 65 72 2c | 20 74 68 65 20 41 70 70 | server,| the App|
|000056d0| 6c 65 53 65 61 72 63 68 | 20 43 6f 6d 6d 75 6e 69 |leSearch| Communi|
|000056e0| 63 61 74 69 6f 6e 20 45 | 78 74 65 6e 73 69 6f 6e |cation E|xtension|
|000056f0| 20 73 65 6e 64 73 20 61 | 20 72 65 70 6c 79 20 41 | sends a| reply A|
|00005700| 70 70 6c 65 20 65 76 65 | 6e 74 20 62 61 63 6b 20 |pple eve|nt back |
|00005710| 74 6f 20 79 6f 75 72 20 | 61 70 70 6c 69 63 61 74 |to your |applicat|
|00005720| 69 6f 6e 2e 20 0d 46 6f | 72 20 65 78 61 6d 70 6c |ion. .Fo|r exampl|
|00005730| 65 2c 20 74 6f 20 63 6f | 6e 64 75 63 74 20 61 6e |e, to co|nduct an|
|00005740| 20 69 6d 6d 65 64 69 61 | 74 65 20 73 65 61 72 63 | immedia|te searc|
|00005750| 68 20 79 6f 75 20 6e 65 | 65 64 20 74 6f 20 73 65 |h you ne|ed to se|
|00005760| 6e 64 20 61 6e 20 41 70 | 70 6c 65 20 65 76 65 6e |nd an Ap|ple even|
|00005770| 74 20 6f 66 20 65 76 65 | 6e 74 20 63 6c 61 73 73 |t of eve|nt class|
|00005780| 20 6b 41 70 70 6c 65 53 | 65 61 72 63 68 52 65 71 | kAppleS|earchReq|
|00005790| 75 65 73 74 20 61 6e 64 | 20 65 76 65 6e 74 20 49 |uest and| event I|
|000057a0| 44 20 6b 41 45 41 53 53 | 65 61 72 63 68 20 77 69 |D kAEASS|earch wi|
|000057b0| 74 68 20 61 70 70 72 6f | 70 72 69 61 74 65 20 70 |th appro|priate p|
|000057c0| 61 72 61 6d 65 74 65 72 | 73 2e 20 54 68 65 20 41 |arameter|s. The A|
|000057d0| 70 70 6c 65 53 65 61 72 | 63 68 20 43 6f 6d 6d 75 |ppleSear|ch Commu|
|000057e0| 6e 69 63 61 74 69 6f 6e | 20 45 78 74 65 6e 73 69 |nication| Extensi|
|000057f0| 6f 6e 20 70 61 63 6b 61 | 67 65 73 20 74 68 65 20 |on packa|ges the |
|00005800| 73 65 61 72 63 68 20 70 | 61 72 61 6d 65 74 65 72 |search p|arameter|
|00005810| 73 20 69 6e 74 6f 20 61 | 6e 20 61 70 70 72 6f 70 |s into a|n approp|
|00005820| 72 69 61 74 65 20 70 61 | 72 61 6d 65 74 65 72 20 |riate pa|rameter |
|00005830| 62 6c 6f 63 6b 20 61 6e | 64 20 74 68 65 6e 20 73 |block an|d then s|
|00005840| 65 6e 64 73 20 61 20 73 | 65 61 72 63 68 20 72 65 |ends a s|earch re|
|00005850| 71 75 65 73 74 20 74 6f | 20 74 68 65 20 73 65 72 |quest to| the ser|
|00005860| 76 65 72 2e 20 41 66 74 | 65 72 20 74 68 65 20 73 |ver. Aft|er the s|
|00005870| 65 72 76 65 72 20 72 65 | 73 70 6f 6e 64 73 20 74 |erver re|sponds t|
|00005880| 6f 20 74 68 65 20 72 65 | 71 75 65 73 74 2c 20 61 |o the re|quest, a|
|00005890| 20 72 65 70 6c 79 20 6f | 66 20 65 76 65 6e 74 20 | reply o|f event |
|000058a0| 63 6c 61 73 73 20 6b 43 | 6f 72 65 45 76 65 6e 74 |class kC|oreEvent|
|000058b0| 43 6c 61 73 73 20 61 6e | 64 20 65 76 65 6e 74 20 |Class an|d event |
|000058c0| 49 44 20 6b 41 45 41 6e | 73 77 65 72 2c 20 77 68 |ID kAEAn|swer, wh|
|000058d0| 69 63 68 20 63 6f 6e 74 | 61 69 6e 73 20 61 20 73 |ich cont|ains a s|
|000058e0| 65 61 72 63 68 20 72 65 | 73 75 6c 74 2c 20 77 69 |earch re|sult, wi|
|000058f0| 6c 6c 20 62 65 20 72 65 | 74 75 72 6e 65 64 2e 20 |ll be re|turned. |
|00005900| 0d 54 68 65 20 66 6f 6c | 6c 6f 77 69 6e 67 20 64 |.The fol|lowing d|
|00005910| 69 61 67 72 61 6d 20 73 | 68 6f 77 73 20 74 68 65 |iagram s|hows the|
|00005920| 20 72 65 6c 61 74 69 6f | 6e 73 68 69 70 20 62 65 | relatio|nship be|
|00005930| 74 77 65 65 6e 20 61 6e | 20 41 70 70 6c 65 53 65 |tween an| AppleSe|
|00005940| 61 72 63 68 20 72 65 71 | 75 65 73 74 20 61 6e 64 |arch req|uest and|
|00005950| 20 69 74 73 20 72 65 70 | 6c 69 65 73 2e 0d 20 0d | its rep|lies.. .|
|00005960| 54 68 65 20 41 70 70 6c | 65 53 65 61 72 63 68 20 |The Appl|eSearch |
|00005970| 43 6f 6d 6d 75 6e 69 63 | 61 74 69 6f 6e 20 45 78 |Communic|ation Ex|
|00005980| 74 65 6e 73 69 6f 6e 0d | 54 68 65 20 41 70 70 6c |tension.|The Appl|
|00005990| 65 53 65 61 72 63 68 20 | 43 6f 6d 6d 75 6e 69 63 |eSearch |Communic|
|000059a0| 61 74 69 6f 6e 20 45 78 | 74 65 6e 73 69 6f 6e 20 |ation Ex|tension |
|000059b0| 69 73 20 61 20 62 61 63 | 6b 67 72 6f 75 6e 64 2d |is a bac|kground-|
|000059c0| 6f 6e 6c 79 20 70 72 6f | 63 65 73 73 20 74 68 61 |only pro|cess tha|
|000059d0| 74 20 72 65 63 65 69 76 | 65 73 20 41 70 70 6c 65 |t receiv|es Apple|
|000059e0| 20 65 76 65 6e 74 73 20 | 66 72 6f 6d 20 61 6e 6f | events |from ano|
|000059f0| 74 68 65 72 20 61 70 70 | 6c 69 63 61 74 69 6f 6e |ther app|lication|
|00005a00| 20 28 73 75 63 68 20 61 | 73 20 79 6f 75 72 20 63 | (such a|s your c|
|00005a10| 75 73 74 6f 6d 20 63 6c | 69 65 6e 74 29 20 61 6e |ustom cl|ient) an|
|00005a20| 64 20 69 6e 20 74 75 72 | 6e 20 63 6f 6d 6d 75 6e |d in tur|n commun|
|00005a30| 69 63 61 74 65 73 20 77 | 69 74 68 20 61 6e 20 41 |icates w|ith an A|
|00005a40| 70 70 6c 65 53 65 61 72 | 63 68 20 73 65 72 76 65 |ppleSear|ch serve|
|00005a50| 72 2e 20 46 6f 72 20 65 | 78 61 6d 70 6c 65 2c 20 |r. For e|xample, |
|00005a60| 77 68 65 6e 20 79 6f 75 | 72 20 61 70 70 6c 69 63 |when you|r applic|
|00005a70| 61 74 69 6f 6e 20 73 65 | 6e 64 73 20 61 20 53 65 |ation se|nds a Se|
|00005a80| 61 72 63 68 20 65 76 65 | 6e 74 20 74 6f 20 74 68 |arch eve|nt to th|
|00005a90| 65 20 41 70 70 6c 65 53 | 65 61 72 63 68 20 43 6f |e AppleS|earch Co|
|00005aa0| 6d 6d 75 6e 69 63 61 74 | 69 6f 6e 20 45 78 74 65 |mmunicat|ion Exte|
|00005ab0| 6e 73 69 6f 6e 2c 20 69 | 74 20 63 68 65 63 6b 73 |nsion, i|t checks|
|00005ac0| 20 70 61 72 61 6d 65 74 | 65 72 73 20 61 6e 64 20 | paramet|ers and |
|00005ad0| 74 68 65 6e 20 69 73 73 | 75 65 73 20 61 20 73 65 |then iss|ues a se|
|00005ae0| 61 72 63 68 20 72 65 71 | 75 65 73 74 20 74 6f 20 |arch req|uest to |
|00005af0| 74 68 65 20 73 65 72 76 | 65 72 20 69 74 20 69 73 |the serv|er it is|
|00005b00| 20 6c 6f 67 67 65 64 20 | 6f 6e 20 74 6f 2c 20 75 | logged |on to, u|
|00005b10| 73 69 6e 67 20 74 68 65 | 20 41 70 70 6c 65 53 65 |sing the| AppleSe|
|00005b20| 61 72 63 68 20 43 6c 69 | 65 6e 74 2f 53 65 72 76 |arch Cli|ent/Serv|
|00005b30| 65 72 20 70 72 6f 74 6f | 63 6f 6c 2e 20 57 68 65 |er proto|col. Whe|
|00005b40| 6e 20 61 20 72 65 70 6c | 79 20 63 6f 6d 65 73 20 |n a repl|y comes |
|00005b50| 62 61 63 6b 20 66 72 6f | 6d 20 74 68 65 20 73 65 |back fro|m the se|
|00005b60| 72 76 65 72 2c 20 74 68 | 65 20 41 70 70 6c 65 53 |rver, th|e AppleS|
|00005b70| 65 61 72 63 68 20 43 6f | 6d 6d 75 6e 69 63 61 74 |earch Co|mmunicat|
|00005b80| 69 6f 6e 20 45 78 74 65 | 6e 73 69 6f 6e 20 73 65 |ion Exte|nsion se|
|00005b90| 6e 64 73 20 61 20 73 65 | 61 72 63 68 20 72 65 70 |nds a se|arch rep|
|00005ba0| 6c 79 20 65 76 65 6e 74 | 20 74 6f 20 79 6f 75 72 |ly event| to your|
|00005bb0| 20 61 70 70 6c 69 63 61 | 74 69 6f 6e 2e 20 49 6e | applica|tion. In|
|00005bc0| 20 65 73 73 65 6e 63 65 | 2c 20 74 68 65 20 41 70 | essence|, the Ap|
|00005bd0| 70 6c 65 53 65 61 72 63 | 68 20 43 6f 6d 6d 75 6e |pleSearc|h Commun|
|00005be0| 69 63 61 74 69 6f 6e 20 | 45 78 74 65 6e 73 69 6f |ication |Extensio|
|00005bf0| 6e 20 61 70 70 65 61 72 | 73 20 61 73 20 61 20 73 |n appear|s as a s|
|00005c00| 65 72 76 65 72 20 74 6f | 20 79 6f 75 72 20 61 70 |erver to| your ap|
|00005c10| 70 6c 69 63 61 74 69 6f | 6e 2e 20 0d 42 65 66 6f |plicatio|n. .Befo|
|00005c20| 72 65 20 73 65 6e 64 69 | 6e 67 20 61 6e 79 20 41 |re sendi|ng any A|
|00005c30| 70 70 6c 65 20 65 76 65 | 6e 74 20 74 6f 20 74 68 |pple eve|nt to th|
|00005c40| 65 20 41 70 70 6c 65 53 | 65 61 72 63 68 20 43 6f |e AppleS|earch Co|
|00005c50| 6d 6d 75 6e 69 63 61 74 | 69 6f 6e 20 45 78 74 65 |mmunicat|ion Exte|
|00005c60| 6e 73 69 6f 6e 2c 20 79 | 6f 75 72 20 61 70 70 6c |nsion, y|our appl|
|00005c70| 69 63 61 74 69 6f 6e 20 | 6d 75 73 74 20 64 65 74 |ication |must det|
|00005c80| 65 72 6d 69 6e 65 20 77 | 68 65 74 68 65 72 20 74 |ermine w|hether t|
|00005c90| 68 65 20 65 78 74 65 6e | 73 69 6f 6e 20 69 73 20 |he exten|sion is |
|00005ca0| 61 6c 72 65 61 64 79 20 | 72 75 6e 6e 69 6e 67 2e |already |running.|
|00005cb0| 20 49 66 20 6e 6f 74 2c | 20 79 6f 75 72 20 61 70 | If not,| your ap|
|00005cc0| 70 6c 69 63 61 74 69 6f | 6e 20 6e 65 65 64 73 20 |plicatio|n needs |
|00005cd0| 74 6f 20 66 69 6e 64 20 | 69 74 20 61 6e 64 20 6c |to find |it and l|
|00005ce0| 61 75 6e 63 68 20 69 74 | 2e 20 53 69 6e 63 65 20 |aunch it|. Since |
|00005cf0| 74 68 65 20 41 70 70 6c | 65 53 65 61 72 63 68 20 |the Appl|eSearch |
|00005d00| 43 6f 6d 6d 75 6e 69 63 | 61 74 69 6f 6e 20 45 78 |Communic|ation Ex|
|00005d10| 74 65 6e 73 69 6f 6e 20 | 69 73 20 61 20 73 79 73 |tension |is a sys|
|00005d20| 74 65 6d 20 65 78 74 65 | 6e 73 69 6f 6e 2c 20 69 |tem exte|nsion, i|
|00005d30| 74 20 63 61 6e 20 62 65 | 20 66 6f 75 6e 64 20 69 |t can be| found i|
|00005d40| 6e 20 74 68 65 20 45 78 | 74 65 6e 73 69 6f 6e 73 |n the Ex|tensions|
|00005d50| 20 66 6f 6c 64 65 72 2e | 20 59 6f 75 72 20 61 70 | folder.| Your ap|
|00005d60| 70 6c 69 63 61 74 69 6f | 6e 20 63 61 6e 20 66 69 |plicatio|n can fi|
|00005d70| 6e 64 20 69 74 20 62 79 | 20 6d 61 6b 69 6e 67 20 |nd it by| making |
|00005d80| 61 20 50 42 43 61 74 53 | 65 61 72 63 68 20 63 61 |a PBCatS|earch ca|
|00005d90| 6c 6c 20 77 69 74 68 20 | 74 68 65 20 41 70 70 6c |ll with |the Appl|
|00005da0| 65 53 65 61 72 63 68 20 | 43 6f 6d 6d 75 6e 69 63 |eSearch |Communic|
|00005db0| 61 74 69 6f 6e 20 45 78 | 74 65 6e 73 69 6f 6e d5 |ation Ex|tension.|
|00005dc0| 73 20 63 72 65 61 74 6f | 72 20 74 79 70 65 20 61 |s creato|r type a|
|00005dd0| 6e 64 20 45 78 74 65 6e | 73 69 6f 6e 73 20 66 6f |nd Exten|sions fo|
|00005de0| 6c 64 65 72 20 61 73 20 | 74 68 65 20 70 61 72 65 |lder as |the pare|
|00005df0| 6e 74 20 64 69 72 65 63 | 74 6f 72 79 2e 20 54 68 |nt direc|tory. Th|
|00005e00| 65 6e 2c 20 79 6f 75 20 | 63 61 6e 20 6d 61 6b 65 |en, you |can make|
|00005e10| 20 61 6e 20 46 53 53 70 | 65 63 20 6f 75 74 20 6f | an FSSp|ec out o|
|00005e20| 66 20 74 68 65 20 43 61 | 74 53 65 61 72 63 68 20 |f the Ca|tSearch |
|00005e30| 70 61 72 61 6d 65 74 65 | 72 20 62 6c 6f 63 6b 20 |paramete|r block |
|00005e40| 61 6e 64 20 75 73 65 20 | 69 74 20 69 6e 20 74 68 |and use |it in th|
|00005e50| 65 20 4c 61 75 6e 63 68 | 41 70 70 6c 69 63 61 74 |e Launch|Applicat|
|00005e60| 69 6f 6e 20 74 72 61 70 | 2e 20 57 68 65 6e 20 6c |ion trap|. When l|
|00005e70| 61 75 6e 63 68 65 64 2c | 20 74 68 65 20 41 70 70 |aunched,| the App|
|00005e80| 6c 65 53 65 61 72 63 68 | 20 43 6f 6d 6d 75 6e 69 |leSearch| Communi|
|00005e90| 63 61 74 69 6f 6e 20 45 | 78 74 65 6e 73 69 6f 6e |cation E|xtension|
|00005ea0| 20 61 75 74 6f 6d 61 74 | 69 63 61 6c 6c 79 20 64 | automat|ically d|
|00005eb0| 69 73 70 6c 61 79 73 20 | 74 68 65 20 50 50 43 42 |isplays |the PPCB|
|00005ec0| 72 6f 77 73 65 72 20 64 | 69 61 6c 6f 67 20 62 6f |rowser d|ialog bo|
|00005ed0| 78 2c 20 70 72 6f 6d 70 | 74 69 6e 67 20 74 68 65 |x, promp|ting the|
|00005ee0| 20 75 73 65 72 20 74 6f | 20 73 65 6c 65 63 74 20 | user to| select |
|00005ef0| 61 6e 20 41 70 70 6c 65 | 53 65 61 72 63 68 20 73 |an Apple|Search s|
|00005f00| 65 72 76 65 72 20 74 6f | 20 63 6f 6e 6e 65 63 74 |erver to| connect|
|00005f10| 20 74 6f 2e 20 49 66 20 | 74 68 65 20 75 73 65 72 | to. If |the user|
|00005f20| 20 69 73 20 73 75 63 63 | 65 73 73 66 75 6c 6c 79 | is succ|essfully|
|00005f30| 20 61 75 74 68 65 6e 74 | 69 63 61 74 65 64 2c 20 | authent|icated, |
|00005f40| 61 20 73 65 73 73 69 6f | 6e 20 69 73 20 65 73 74 |a sessio|n is est|
|00005f50| 61 62 6c 69 73 68 65 64 | 20 62 65 74 77 65 65 6e |ablished| between|
|00005f60| 20 74 68 65 20 63 6c 69 | 65 6e 74 20 61 6e 64 20 | the cli|ent and |
|00005f70| 74 68 65 20 73 65 72 76 | 65 72 2e 20 49 66 20 74 |the serv|er. If t|
|00005f80| 68 65 20 75 73 65 72 20 | 64 6f 65 73 20 6e 6f 74 |he user |does not|
|00005f90| 20 63 6f 6e 6e 65 63 74 | 20 74 6f 20 74 68 65 20 | connect| to the |
|00005fa0| 73 65 72 76 65 72 20 70 | 72 6f 70 65 72 6c 79 2c |server p|roperly,|
|00005fb0| 20 74 68 65 20 41 70 70 | 6c 65 53 65 61 72 63 68 | the App|leSearch|
|00005fc0| 20 43 6f 6d 6d 75 6e 69 | 63 61 74 69 6f 6e 20 45 | Communi|cation E|
|00005fd0| 78 74 65 6e 73 69 6f 6e | 20 73 65 6e 64 73 20 61 |xtension| sends a|
|00005fe0| 6e 20 65 72 72 6f 72 20 | 6d 65 73 73 61 67 65 20 |n error |message |
|00005ff0| 74 6f 20 79 6f 75 72 20 | 61 70 70 6c 69 63 61 74 |to your |applicat|
|00006000| 69 6f 6e 20 61 6e 64 20 | 71 75 69 74 73 2e 20 0d |ion and |quits. .|
|00006010| 54 68 65 20 66 6f 6c 6c | 6f 77 69 6e 67 20 73 61 |The foll|owing sa|
|00006020| 6d 70 6c 65 20 63 6f 64 | 65 20 64 65 6d 6f 6e 73 |mple cod|e demons|
|00006030| 74 72 61 74 65 73 20 68 | 6f 77 20 74 6f 20 66 69 |trates h|ow to fi|
|00006040| 6e 64 20 61 6e 64 20 6c | 61 75 6e 63 68 20 74 68 |nd and l|aunch th|
|00006050| 65 20 41 70 70 6c 65 53 | 65 61 72 63 68 20 43 6f |e AppleS|earch Co|
|00006060| 6d 6d 75 6e 69 63 61 74 | 69 6f 6e 20 45 78 74 65 |mmunicat|ion Exte|
|00006070| 6e 73 69 6f 6e 20 66 72 | 6f 6d 20 79 6f 75 72 20 |nsion fr|om your |
|00006080| 61 70 70 6c 69 63 61 74 | 69 6f 6e 2e 20 0d 2f 2f |applicat|ion. .//|
|00006090| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000060a0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000060b0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000060c0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000060d0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 0d 2f 2f 20 |________|____.// |
|000060e0| 46 75 6e 63 74 69 6f 6e | 3a 09 09 4c 61 75 6e 63 |Function|:..Launc|
|000060f0| 68 41 53 43 6f 6d 6d 75 | 6e 69 63 61 74 69 6f 6e |hASCommu|nication|
|00006100| 20 0d 2f 2f 20 41 62 73 | 74 72 61 63 74 3a 09 09 | .// Abs|tract:..|
|00006110| 44 65 74 65 72 6d 69 6e | 65 73 20 69 66 20 74 68 |Determin|es if th|
|00006120| 65 20 41 70 70 6c 65 53 | 65 61 72 63 68 20 43 6f |e AppleS|earch Co|
|00006130| 6d 6d 75 6e 69 63 61 74 | 69 6f 6e 20 65 78 74 65 |mmunicat|ion exte|
|00006140| 6e 73 69 6f 6e 20 69 73 | 20 0d 2f 2f 09 09 09 09 |nsion is| .//....|
|00006150| 09 09 72 75 6e 6e 69 6e | 67 2e 20 20 49 66 20 69 |..runnin|g. If i|
|00006160| 74 20 69 73 20 6e 6f 74 | 20 79 65 74 20 72 75 6e |t is not| yet run|
|00006170| 6e 69 6e 67 2c 20 69 74 | 20 74 72 69 65 73 20 74 |ning, it| tries t|
|00006180| 6f 20 6c 61 75 6e 63 68 | 20 69 74 2e 0d 2f 2f 20 |o launch| it..// |
|00006190| 50 61 72 61 6d 65 74 65 | 72 73 3a 09 09 69 73 52 |Paramete|rs:..isR|
|000061a0| 75 6e 6e 69 6e 67 20 2d | 20 54 68 69 73 20 76 61 |unning -| This va|
|000061b0| 6c 75 65 20 67 65 74 73 | 20 73 65 74 20 74 6f 20 |lue gets| set to |
|000061c0| 74 72 75 65 20 69 66 20 | 74 68 65 20 65 78 74 65 |true if |the exte|
|000061d0| 6e 73 69 6f 6e 20 69 73 | 0d 2f 2f 09 09 09 09 09 |nsion is|.//.....|
|000061e0| 09 61 6c 72 65 61 64 79 | 20 72 75 6e 6e 69 6e 67 |.already| running|
|000061f0| 2c 20 6f 72 20 69 74 20 | 77 61 73 20 73 75 63 63 |, or it |was succ|
|00006200| 65 73 73 66 75 6c 6c 79 | 20 6c 61 75 6e 63 68 65 |essfully| launche|
|00006210| 64 20 62 79 20 74 68 69 | 73 0d 2f 2f 09 09 09 09 |d by thi|s.//....|
|00006220| 09 09 66 75 6e 63 74 69 | 6f 6e 2e 0d 2f 2f 20 52 |..functi|on..// R|
|00006230| 65 74 75 72 6e 73 3a 09 | 09 09 4f 53 45 72 72 20 |eturns:.|..OSErr |
|00006240| 2d 20 49 66 20 74 68 65 | 20 65 78 74 65 6e 73 69 |- If the| extensi|
|00006250| 6f 6e 20 77 61 73 6e d5 | 74 20 61 6c 72 65 61 64 |on wasn.|t alread|
|00006260| 79 20 72 75 6e 6e 69 6e | 67 20 61 6e 64 20 74 68 |y runnin|g and th|
|00006270| 65 20 61 74 74 65 6d 70 | 74 0d 2f 2f 09 09 09 09 |e attemp|t.//....|
|00006280| 09 09 74 6f 20 6c 61 75 | 6e 63 68 20 66 61 69 6c |..to lau|nch fail|
|00006290| 65 64 2c 20 74 68 65 20 | 65 72 72 6f 72 20 63 6f |ed, the |error co|
|000062a0| 64 65 20 66 72 6f 6d 20 | 74 68 65 20 61 74 74 65 |de from |the atte|
|000062b0| 6d 70 74 20 69 73 20 72 | 65 74 75 72 6e 65 64 2e |mpt is r|eturned.|
|000062c0| 0d 2f 2f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |.//_____|________|
|000062d0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000062e0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|000062f0| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 5f |________|________|
|00006300| 5f 5f 5f 5f 5f 5f 5f 5f | 5f 5f 5f 5f 5f 5f 5f 0d |________|_______.|
|00006310| 4f 53 45 72 72 20 4c 61 | 75 6e 63 68 41 53 43 6f |OSErr La|unchASCo|
|00006320| 6d 6d 75 6e 69 63 61 74 | 69 6f 6e 28 20 42 6f 6f |mmunicat|ion( Boo|
|00006330| 6c 65 61 6e 2a 20 69 73 | 52 75 6e 6e 69 6e 67 20 |lean* is|Running |
|00006340| 29 0d 7b 0d 09 4f 53 45 | 72 72 09 09 09 09 65 72 |).{..OSE|rr....er|
|00006350| 72 20 3d 20 6e 6f 45 72 | 72 3b 0d 09 63 6f 6e 73 |r = noEr|r;..cons|
|00006360| 74 20 4f 53 54 79 70 65 | 09 6b 41 53 43 6f 6d 6d |t OSType|.kASComm|
|00006370| 75 6e 69 63 61 74 69 6f | 6e 53 69 67 6e 61 74 75 |unicatio|nSignatu|
|00006380| 72 65 20 3d 20 d4 62 67 | 64 70 d5 3b 0d 09 69 66 |re = .bg|dp.;..if|
|00006390| 20 28 20 41 70 70 6c 69 | 63 61 74 69 6f 6e 49 73 | ( Appli|cationIs|
|000063a0| 52 75 6e 6e 69 6e 67 28 | 20 6b 41 53 43 6f 6d 6d |Running(| kASComm|
|000063b0| 75 6e 69 63 61 74 69 6f | 6e 53 69 67 6e 61 74 75 |unicatio|nSignatu|
|000063c0| 72 65 20 29 20 29 20 7b | 0d 09 09 09 2a 69 73 52 |re ) ) {|....*isR|
|000063d0| 75 6e 6e 69 6e 67 20 3d | 20 74 72 75 65 3b 0d 09 |unning =| true;..|
|000063e0| 7d 0d 09 65 6c 73 65 20 | 7b 0d 09 09 65 72 72 20 |}..else |{...err |
|000063f0| 3d 20 4c 61 75 6e 63 68 | 4d 79 45 78 74 65 6e 73 |= Launch|MyExtens|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.
